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© Preface 


The 3890-2 Disk Storage Subsystem is a high performance DASD subsystem that 
consists of the 3898-2 Cluster Control Unit and one or more 3890 Disk Modules. This 
subsystem offers the customer increased storage capacity, reduced floor space 
requirements, and a host of other benefits. To familiarize the customer with the 3890-2 
subsystem, Memorex Telex publishes several manuals and brochures that describe 
various aspects of the product line. Some of this material focuses on the advantages and 
design of the subsystem; other documents furnish planning information, hardware 
descriptions, etc. of the Product Reference Manual. The purpose of the Product Reference 
Manual is to familiarize the opesator and system programmer with the basic subsystem 
components, the operator control panel, the command range, the track format, and a 
variety of related subjects. Customers who have already acquired a 3890-2 subsystem 
will find this manual valuable when developing command sequences, migrating datasets, 
and training system operators. Customers planning to install a 3890-2 subsystem should 
also review this manual for a fuller understanding of how the subsystem will adapt to the 
existing environment. The 3890-2 Product Reference Manual is structured as follows: 


Note: For the purposes of this manual, the term “3898" refers to the 3898-2 Cluster 
Control Unit and the term "3890" refers to the 3890 Disk Module unless 
otherwise specified. 


Section 1 — This section introduces the 3890-2 subsystem, briefly describing the cluster 
control unit and drive modules available at this time. Additionally, Section 1 outlines 
the system operator’s responsibilities in regard to the subsystem as well as the safety 
precautions that all personnel must observe. 


Section 2 — This section provides a detailed discussion of the subsystem operator 
contro] panel switches and indicators. As a reference for the operator, Section 2 also 
summarizes a typical power-up sequence, power-down sequence, and an emergency 
power shutdown. 


Section 3 — This section furnishes a complete description of all channel commands 
accepted by the 3898-2. When applicable, the write-up includes chaining requirements. 
Section 3 also defines the unit status area, an integral part of the Channel Status Word. 


Section 4 — This section briefly reviews the track and record format used by the 3890 
disk drive. Section 4 provides a visual layout of the track format as well as a description 
of each field. 


Section 5 — This section describes the basics of 3898-2 error handling. Items of interest 
include the retry function and error correction. 


Section 6 — This section covers the statistical/error recording function. In a related 
discussion, Section 6 lists and defines Sense Bytes 0 through 7 as logged under the 


various formats. Additionally, this section furnishes a table of Sense Byte 7 messages. 


Appendix A — This appendix defines the abbreviations used in this manual. 
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Appendix B — This appendix furnishes data conversion and software planning 
information along with track storage capacities for given record lengths. Appendix B will wa 
be of particular interest to the system programmer. 


To supplement the Product Reference Manual, Memorex Telex provides a companion 
manual — the 3890-2 General Information Manual. Designed for use during the system 
planning phase, the General Information Manual focuses on issues that prove crucial 
when developing an overall subsystem configuration scheme. This manual also proves a 
handy reference for those who wish to familiarize themselves with subsystem 
performance, features, and hardware. In addition to user documentation, Memorex Telex 
provides a full range of service documentation for the 3890-2 subsystem. This 
documentation includes such items as maintenance manuals, functional descriptions, 
etc., and is listed below. 


Publication 
Document Number 
3890-2 Maintenance Manual 3890-2.20-xx 
3890-2 Functional Description 3890-2.21-xx 
3890-2 Installation Manual 3890-2.22-xx (Ee 
3890-2 Illustrated Parts Catalog 3890-2.23-xx | 
3890-2 Fault Isolation Procedure (FIPs) Manual 3890-2.24-xx J 
3890-2 Microdiagnostics Reference Manual 3890-2.50-xx 
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Introduction 7 


1.1 General Discussion 


The 3890-2 Disk Storage Subsystem is a high-performance, fast-access disk subsystem 
designed to meet the needs of a sophisticated data processing environment. With 
computer facility real estate at a premium, the system planner has become increasingly 
concerned with the amount of spaceér@guired per megabyte (MB) of storage. In answer to 
this concern, the 3890-2 subsystem provides larger storage capacities per square foot of 
floor space than earlier product generations. At the same time, the subsystem features 
improved reliability and quicker data turnaround. The configuration strategy for the 
3890-2 emphasizes the subsystem’s flexibility; the 3890-2 can attach to a wide range of 
mainframes in a variety of different operating environments. The planner will also find 
the 3890 disk module’s intermixed configurations highly adaptable to the specific 
requirements of the site. The numerous advantages offered by the 3890-2 subsystem 
make it one of the most cost effective DASD offerings of its kind. 


The 3890-2 subsystem is composed of two major elements: the 3898-2 Cluster Control 
Unit and the 3890 Disk Module. The disk module attaches to the 3898-2 anda 
maximum configuration may include four modules. The following paragraphs briefly 
review each of these units, focusing on the distinguishing characteristics of each. Fora 
more detailed discussion of 3890-2 subsystem hardware, configurations, features, and 
installation planning, the reader may refer to the 3890-2 General Information Manual, 
this publication is considered a prerequisite to the Product Reference Manual. 


1.1.1. Cluster Control Unit - 


The 3898-2 Cluster Control Unit provides the basic control logic and power sequencing 
for the subsystem. From an architectural point of view, the 3898-2 incorporates two 
storage clusters; each cluster contains two independent storage paths (SPs) that perform 
the majority of the functional management tasks. The 3898-2 is also equipped with a 
subsystem control panel, a power subsystem, a cooling system, and an external interface. 
In a standard channel configuration, each of the four available SPs attach to two IBM (or 
IBM-compatible) block multiplexer channels. One or more SPs can be attached to the 
same channel, or the four SPs can be attached to separate channels in the same 
processor, or to channels in different processors. To increase channel accessibility, the 
3898-2 can be equipped with the optional four-channel switch feature which allows 
access through sixteen channels, four channel attachments per SP. The SPs are capable 
of transferring data to and from the channels at a rate of 3.0 megabytes/second for disk 
transactions. Individual SPs can handle up to 60.24 gigabytes (GB) of online storage in 
an address range that does not exceed 64 volumes, although 3898-2-based subsystems 
can also be configured with a variety of intermediate storage capacities. 


3890-2.01-00 — 09/90 1-1 


Disk Module 


1.1.2 Disk Module 


The 3890-2 subsytem supports up to four 3890 Disk Modules. Each disk module provides 
the following basic components: an SP/device interface, redundant interface power 
supplies, and a set of either four, eight, twelve, or sixteen drive drawers. The SP/device 
interface handles a number of conversions and communications tasks for the volumes, 
and is composed of a number of printed circuit boards (PCBs) housed in a logic gate near 
the rear of the cabinet. The logic gate is powered by two power supplies; one power 
supply can act as a backup for the other in an emergency situation. Each drive drawer 
houses a high-reliability disk drive, a disk drive power supply, and a cooling system. 
Drive drawers are installed in sets of four and a set is referred to as a storage increment. 
The 3890 disk module is available in three versions depending on the type of storage 
increments it contains: the J-type module, the K-type module, or an intermixed module. 
Table 1-1 summarizes the available configurations of the disk modules to provide an, 
overview of the different storage options the subsystem may contain. 
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Table 1-1. Configuration Storage Capacities (Gigabytes) 


Storage Disk Intermix 
increments Modules Capacity - 
(Drawers) Required J Capacity K Capacity (J + K Volumes 


1 (4) 0 
2 (8) 0 
3 (12) 8.92 (BJ + 2K) 
4 (16) 12.60 
5 (20) 13.86 
16.38 
6 (24) 20.16 
17.64 
7 (28) 23.94 
21.42 
8 (32) 27.72 
25.20 
9 (36) 31.50 (80+ 12K + 4J) 
28.98 (16J + 10K) 
| 32.76 
10 (40) | 32.76 
32.76 
35.28 
11 (44) 35.28 (8) + 12K + 12J) 
36.54 (16J + 14K) 
37.80 (16K + 12J) 
12 (48) 37.80 (8J+12K+ 16J) 
C 40.32 (16J+ 16K) 
, 40.32 
13 (52) 40.32 
44.10 (16J + 18K) 
42.84 (16K + 20J) 
14 (56) 42.84 
47.88 
45.36 
15 (60) 45.36 
51.66 
47.88 
16 (64) 47.88 
55.44 
50.40 


* Volumes are presented in the order of their addressed priorities. 
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1.2 Operator Responsibilities 


1-4 


The operator’s responsibilities in regard to the 3890-2 are minimal. The following list 
identifies each of these tasks. 


The operator must comply with all safety precautions discussed in paragraph 1.3. 


2. The operator must be familiar with the subsystem emergency power shutdown 
procedure. 


3. The operator should be familiar with the switches and indicators on the operator 
control panels. 


4. Ifthe subsystem is in local mode (see Section 2), the operator must use the 
switches on the operator control panels to power the subsystem up and down. 


5. Ifso chartered, the operator must regularly back up the data stdred on all 3890 
volumes. 


6. Ifthe cabinet is smudged, the operator should clean the cover with glass cleaner 
and a disposable wiper. Do not spray the glass cleaner directly on the equipment. 
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( 1.3 Safety Precautions 


All personnel working in the computer facility must observe the following precautions in 
regard to the 3890-2 subsystem. 


1. Know your fire protection system. If total COg flooding or halon is used, know 
the warning signal and escape routes. 


2. Perform an emergercy power shutdown if hazardous conditions occur. 
3. Do not remove the cabinet covers for any reason. 


4. Ifthe covers have been removed by a CE during a service call, do not touch the 
unit. When near-the unit, pay special heed to the following warning stickers. 


This symbokindicates that the component in question contains uninsulated 
voltages that can cause electrical shock. Avoid any contact with the 
component; serious personal injury can result. 


This symbol indicates that the CE should refer to the installation or 
maintenance manual before attempting to service the component in question. 
Always observe this restriction and avoid contact with the component. 


This symbol indicates that the component in question contains the main 
grounding point for the subsystem. This grounding point must remain 
attached unless the subsystem has been disconnected from the facility 
power source for maintenance. The operator should avoid this area. 


cq Heed all warnings, cautions, or danger labels applied to the surface of an exposed 
component of the equipment. 

Do not impede cabinet airflow in any way. 

Do not lean on the cabinets. 

Do not lean objects against the cabinets. 


Do not rest anything on the top of the cabinets. 


OOM NH MH 


Do not eat, drink, or smoke near the equipment. Observe all other site restrictions. 


10. Ensure that every visitor to the facility is aware of these safety precautions and 
complies with them at all times. 


i 
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€ Section 2 
Control Panel and Power Sequencing 


2.1 General Discussion 


The 3890-2 subsystem is equipped with a complete set of controls that govern subsystem 
power and interface activities; these controls are located on two panels mounted in easily 
accessible areas on the front of the 3898-2 cluster control unit. This section furnishes a 
a3 complete description of the operator control panels and their use during power 

* + sequencing. Among the items discussed are the functional organization of the control 
panels, the actions initiated by each control panel switch, and the significance of each 
indicator. Section 2 also presents, for the J-type module and the K-type module, the 
physical drive layout in relationship to the control panel switches. Additionally, this 
section guides the system operator through a control panel-initiated power up, power 
down, and emergency power down. Before reviewing the body of Section 2, the reader 
should note that the 3890-2 subsystem functions in either local or remote operating mode 
as described in the following paragraph; the selection of the operating mode affects the 
use of the control panel. 


2.2 Local Mode and Remote Mode 


& The 3890-2 subsystem provides the customer with a choice of two operating modes: local 
mode and remote mode. Under local mode, the user manages all subsystem power 
functions and enables/disables all subsystem interfaces from the 3898-2 operator control 
panels. In remote mode, the user initiates all power activities from the host system via 
specific operations; while this mode is activated, many of the operator panel power 
switches will be overridden by the host and, therefore, rendered inoperative. In choosing 
which of these modes will govern the subsystem, the customer must carefully consider 
such issues as general system usage, subsystem accessibility, operator availability, etc. 
Once the operating mode has been selected, the CE will set the subsystem’s internal 
controls appropriately; these controls are not available for general access. The operator 
should make a mental note of which mode is active for a given subsystem so that 
appropriate control procedures can be developed. 


Note: Because remote mode power sequences and commands can vary from CPU to 
CPU, the remainder of this section will be primarily devoted to local mode 
functions. 
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Operator Control Panels 


The cluster control unit provides two panels of switches and indicators which allow the 
system operator to manage all of the storage paths and attached disk modules from one 
convenient location. Each panel provides the controls and indicators for all drives 
(volumes) in the subsystem and two storage paths. The control panel itself comprises 
two subpanels — the operator panel and the maintenance panel. 


The operator panel provides the customer with four control functions: subsystem 
management, SP management, channel interface management, and device (or volume) 
interface management. All operator panel switches and indicators are fully visible to the 
user; each panel is illustrated in Figure 2-1. 


Fhe maintenance panel furnishes a series of contro] functions activated during 
subsystem installation and troubleshooting. Because the maintenance panel is intended 
for CE use only, the panel lies inside the cabinet and cannot be accessed by the operator. 
The ensuing discussion introduces the switches and indicators available on the operator 
control panels and defines their use. To help familiarize the reader with the organization 
of the panels, this presentation has been divided according to the four functional 
categories mentioned in the preceding paragraph. As an additional reference, the 
discussion outlines the relationship between the control panel and the disk volumes. 


Note: Maintenance panel functions are not utilized by the customer and are, 


therefore, omitted from this manual. Reference data on the maintenance 
panel is provided in the 3890-2 Maintenance Manual (3890-2.20-xx). 
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Figure 2-1. Subsystem Operator Control Panels 
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Subsystem Management Switches and Indicators 


2.3.1 Subsystem Management Switches and Indicators (Figure 2-2) 


Subsystem Emergency Power Switch — This lever switch acts as the emergency 
power off (EPO) control for the subsystem. In the Enable (up) position, this switch allows 
power to pass from the wall outlet to the ac input assemblies and, subsequently, to the 
power sequencing unit (PSU), storage paths (SPs), and drives. When pushed down to the 
Off position, this switch immediately trips the main ac input assembly circuit breakers, 
thus halting ac power flow from the ac input assemblies to the subsystem. The operator 
should note that the subsystem cannot be powered up until the circuit breakers have 
been reset by a Memorex Telex CE. 


Note: The detection of some overtemperature conditions will result in subsystem 
power shutdown. This type of shutdown is identical to the EPO sequence 
initiated by the Subsystem Emergency Power switch and requires CE 
intervention to correct. 


Power Sequence Switch — If operating the subsystem in local mode, this momentary 
lever switch controls power to the SPs and the drives. When pressed upward, this switch 
signals the PSU to begin the power-up sequence for the storage paths (providing the SP’s 
power switch is on) and the drives. When pressed downward, this switch inhibits the 
flow of power to the SPs and the drive string. 


If operating the subsystem in remote mode, the Power Sequence switch has no control for ( 7 
powering up but will power down the units. 


Power Sequence Complete Indicator — This LED lights when power is applied to all , 
drives; the drives power up at 10-second intervals starting with Drive 0. The power-up J 
sequence may be initiated via the Power Sequence switch (local mode) or from the host 

system (remote mode). 
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Figure 2-2. Subsystem Management Switches and Indicators 
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P.S. Inop. Indicator — This LED lights when the PSU microcode detects any error in 
the power control subsystem or when any of several subsystem power supplies has 
failed. Since the subsystem is designed to minimize the impact of power faults through 
the use of backup supplies, the LED does not typically indicate that the subsystem has 
halted operations. However, the operator should contact the CE immediately. This 
measure minimizes the risk of downtime in the event that the backup power supply also 
experiences a problem. 


High Temp. Indicator — This LED lights when one or more of the drives or logic gates 
experiences a high temperature condition. The High Temp. LED also remains on for 
most overtemperature conditions although, as already noted, some overtemperature 
conditions will result in a subsystem power shutdown as well. A high temperature 
condition may be isolated to the failing area via a power system diagnostic function. 
High temperature conditions are reported as a warning only. However, the operator is 
encouraged to contact the CE as soon as possible to ensure that the condition is quickly 
remedied. The operator should note that an overtemperature condition will result ina 
shutdown of that part of the subsystem. This could be the drive, a storage path, or the 
whole subsystem. 


Subsystem ID — On the right-hand panel, Subsystem ID is an area reserved for the CE 
to apply an adhesive label which indicates the subsystem identifier. 


2.3.2 SP Management Switches and Indicators (Figure 2-3) 


SP Power Switches (one per SP) — These lever switches furnish SP power control. 
Assuming that the Emergency Power switch is enabled and that the unit has been told to 
power on, the SP Power switch, when set to On, sequences power to the associated SP. If 
set to Off, the switch inhibits power to the SP. 


SP Power Indicators (one per SP) — These LEDs light when the corresponding SP 
has been powered up via the SP Power switch (local mode) or from the computer system 
(remote mode). The LED in question lights approximately two seconds after the 
associated SP Power switch is set or remote power-up occurs. This indicator may turn off 
during certain maintenance procedures. 


SP Pending Indicators (one per SP) — These LEDs light whenever the SP awaits 
acceptance of status bytes by the channel or response to a retry requested for a drive 
experiencing certain errors. 


SP Check Indicators (one per SP) — These LEDs illuminate when the associated SP 
experiences a Check-1 error. Additionally, these indicators flash four times when the 
internal power-up diagnostic series completes successfully. If an SP Check indicator 
lights and remains lit, the corresponding SP is inoperative. 


Device Address — This area of the panel allows the CE to apply an adhesive label to 
the surface of the panel which defines the device (volume) address range accessible to the 
storage paths. 
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Channel Interface Management Switches and Indicators 


The locations of these switches and indicators on the operator control panels are shown 
in Figure 2-3. 

Channel Enabled/Selected Indicators (one per channel for each SP) — These 
dual colored LEDs illuminate in green whenever the associated channel interface is 
logically enabled. These LEDs light in yellow whenever the channel in question selects 
the SP. 


Channel Enabled/Selected Switches (one per channel for each SP) — These lever 
switches, in the enabled (up) position, activate the specified channel for the SP in 
question if that channel is physically installed. When set to the disable (down) position, 
these switches inhibit communication between the specified channel and the SP. 


The area beneath these switches identifies positions reserved for the CE to apply an 
adhesive label which defines either the logical address or the channel path identifier 
(CHPID) for each SP. 
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Device Interface Management Switches and Indicators (Figure 2-4) 


Device Enabled/Selected Switches (on each panel, one per volume) — These lever 
switches are duplicated on each operator control panel as shown in Figure 2-4.~ For the 
device interface to be enabled for all storage paths, the associated switch on both 
operator control panels must be in the up position; if the associated switch is enabled on 
only one control panel, only the storage paths controlled by that panel can access the 
associated volume. Similarly, either switch in the down position inhibits communication 
with the associated volume for the two storage paths managed by that panel. When both 
switches associated with a volume are down, the device interface is disabled for all 
storage paths. 


Device Enabled/Selected Indicators (on each panel, one per volume) — These 
dual colored LEDs light in green whenever the associated deviee interface is logically 
enabled. These LEDs illuminate in yellow whenever the corresponding volume is 
selected for command execution. 


Device Controls Device Controls 


Device Eneblec / Selected 
aS en RS NS NS GD Ds CS | 


OOO0O000 


Device Encbled / Selected 
CO CGC CoO ® Co G&G 


OOO000000 


Device Enabled / — 
cS Se. eS cS 
190 13 #12 #13 #44 ~°«1 


B88a86h6 


Device Encbled / Selected 
Cc OH & OS © oO 
18 #19 1A 18 #1 «#10 


VOD OOO 


eaves ead / pike 


c> 
rT mn oF 23 7 35 76 


&6686486 


Device Enabled / Selected 
Cow wa we we 
28 29 2A 28 2C 20 Fe F 


OOOO OOD 


a pleas f alata 


|) 
7 


30 n 2 3 vy 5 36 0 


OOOO OOO 


Lach el af yolnigel 


3 9 Ta cr 5c 35 cE 7 


OOOO © 


3890-2.01-00 — 09/90 


sab ice Se / suse 
re = > 


56666466 


Device Enobled / Selectec 
Co Cc co mS Gm GG GS CS 


8 9 a B € DOD E F 
QOOOOOOO 
cape ee ee stata 

10 a 12 7 Fi nr rd 7 


VOODOO OO 


atl nate =f alae 


C7 co 
18 ir ry TB Tc 1D 1E oF 


OOOO OG OO 


bali Enabled S pabeigia 


mo ~ 
30 21 22 3 Ja 5 %e 0 


OOO OOOO 


oer thts wa sees 


28 20 20 2€ 2F 


Biatolalelelete 


Device Enabled / Selected 
| nee Os GD Ds GD fe Ss Pe ene ee ene 
30 31 #32 33 34 35 ve rd 


DOOUOO00 


= ce pd aia a oe 
Cc 
38 rr 3A oe ce 30 rd FF 


OOODOO0O00O 


Figure 2-4. Device Interface Management Switches and Indicators 
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The device interface sections of each control panel provide controls for a maximum 
configuration of four J-type disk modules (i.e., 64 addressable units). As an aid to the 
operator, Figures 2-5 and 2-6 illustrate the relationship of the device interface controls 
with specific drives in the subsystem. Figure 2-5 furnishes the layout for the J-type 
module and Figure 2-6 covers the K-type module. In the case of a maximum 
configuration, the 3898-2 provides one Device Enabled/Selected switch per J-type volume 
and all Device Enabled/Selected switches are assigned. In K-type, intermixed versions, 
or smaller configurations, fewer volumes are addressable; therefore, a number of the 
Device Enabled/Selected switches are not connected. When reviewing Figures 2-5 and 
2-6, the operator should recall that one volume is equivalent to one disk drive in aJ-type 
configuration. However, for the K-type configuration, one volume is equivalent to two 
drives. Intermixed versions contain varying storage increments of both types. 
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Figure 2-5. J-Type Disk Module Device Layout 
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Figure 2-6. K-Type Disk Module Device Layout 
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2.4 Power Sequencing 


' As mentioned, subsystem power sequencing may be initiated from the operator control 
- panel or the CPU. Since the topic of power sequencing is an important one, the user 
should acquire a solid background on the subject. In this light, the following paragraphs 
present an overview of power sequencing for the subsystem. The material summarized in 
this discussion includes a typical power-up, a typical power-down, and an emergency 
power-down sequence. Because the remote mode power sequences and commands can 
differ from CPU to CPU, this discussion covers local mode powering only. 


Note: The following discussion is not intended to provide detailed information on 


power sequence signal activity or timing. 


2.4.1. Typical Power-up Sequence 


The following steps present an overview of the basic power-up sequence as initiated in 


local mode. 
1. Atthe operator panel, the user sets the Power Sequence switch to the Up position. 
2. The PSU powers up Drive 0, the Drive 0 power supply, and the Drive 0 fan. 
3. Drive 0 begins disk rotation. 
4. At 10-second intervals, each of the remaining drives receives power, sequences up, 


and begins disk rotation. 


Note: After all of the drives have begun powering up, the Power Sequence Complete 


Oe 


10. 


LED lights. If desired, the operator may perform the remainder of the 
power-up sequence before this LED illuminates. 


At each of the control panels, the user sets the Power switches to the On positions 
for each of the storage paths (SPO and SP1 on the left panel, and SP2 and SP3 on 
the right panel). 


The PSU powers up the SP logic gate fans and the SP power supplies. 

After approximately two seconds, each of the SP Power LEDs light. 

The subsystem initiates the power-up (hardcore) diagnostic routines. 

As the diagnostics execute, each of the SP Check LEDs brightly flash four times. 


After the fourth flash, the user may set the Channel Enabled/Selected and Device 
Enabled/Selected switches to their enabled (up) positions as appropriate to the 
channel configuration. 


Important 


The Device Enabled/Selected switch for the device (volume) must 
be in its up position on both panels for the device (volume) to be 
enabled for all storage paths. 
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ae 
(© 2.4.2 Typical Power-down Sequence 
The following steps present an overview of the basic power-down sequence as initiated in 
local mode. a 
1. Atthe control panels, the user sets all Device Enabled/Selected and Channel 
Enabled/Selected switches to the off (down) position. 
2. The user sets all SP Power switches to their Off positions. 
3. The PSU inhibits power flow to the SP logic gate fans and the SP power supplies. 
4. The SP Power LEDs extinguish. 
“5. The user sets the Power Sequence switch to the Down position. 
* 6. The Power Sequence Complete LED extinguishes. 
7. The PSU inhibits power flow to the individual drives, the drive power supplies, 
and the drive fans. 
8. Each disk drive slows and halts disk rotation. 
2.4.3 Emergency Power-down Sequence 
ae: The emergency power-down sequence is only executed under conditions that pose a 


hazard to personnel or to the equipment. Because customer data (specifically write data) 


can be lost as a result of an emergency shutdown, this sequence should be carefully 
considered before it is initiated. However, once an operator has chosen to perform an 

= emergency shutdown, it should be completed as quickly as possible. Emergency 
power-downs may be initiated from the operator panel (local mode and remote mode). 
For any emergency power-down, the customer must schedule a CE service call prior to 
attempting a subsystem power-up. The following discussion covers the emergency 
power-down sequence. 


1. 


Ae, 
ae 


At the operator panel, the user toggles the Subsystem Emergency Power switch 
to the Off position. 


The 3898-2 trips the internal circuit breakers located in the ac input assemblies. 


The 3898-2 immediately inhibits the flow of ac power past the ac input assemblies 
(i.e., to both the 3898-2 PSU and any attached 3890 disk modules). 


The flow of dc power ceases and all operator panel LEDs extinguish. 
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3.1 Introduction 


For the programmer’s convenience, this section furnishes reference material on the range 
of subsystem commands performed during execution of I/O operations. These commands 
are known as Channel Command Words (CCWs) and are listed in Table 3-1. Table 3-1 is 
followed.by a detailed description of each command, its parameters, and any chaining 
requisements. The command descriptions include specialized information on device type 
where applicable. As an additional reference, Table 3-2 defines Bits 32—39 of the 
Channel Status Word (CSW); this area is known as the Unit Status and can prove useful 
when interpreting the channel commands. 


Table 3-1. Commands 


Command /O 
Word Command Command - Paragraph 
Grouping Word (Hex) Code Number 


Control Commands Define Extent 

| Locate Record 
No-Operation (No-Op) 
Seek 
Seek Cylinder 
Seek Head 
Space Count 
Recalibrate 
Restore 
Set File Mask 
Set Sector 
Set Path Group ID 
Suspend Multipath Reconnection 
Transfer-in-Channel* 


* The x is not significant except in XA mode. Data addresses should continued 
not exceed storage capacity. 
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Table 3-1. Commands (continued) 


Command VO é 
Word Command Command Paragraph 
Grouping Word (Hex) Code Number 


Sense Commands Sense 
Sense ID 
Sense Path Group !D 
Sense Subsystem Status 
Device Reserve 
Device Release 
Unconditional Reserve 
Read Device Characteristics 
Read and Reset Buffered Log 
Reset Allegiance 


Read Commands Read Data 
Multitrack Read Data 
Read Key and Data 
Multitrack Read Key and Data 
Read Count, Key, and Data 
Multitrack Read Count, Key, and Data 
Read Multiple Count, Key, and Data 
Read Record Zero (RO) 
Multitrack Read Record Zero (RO) 
Read Count 
Multitrack Read Count 
Read Home Address 
Multitrack Read Home Address JZ 
Read IPL 
Read Sector 
Read Track 


Write Commands Write Data 
Write Key and Data 
Write Count, Key, and Data 
Write Record Zero (RO) 
Write Home Address 
Erase 
Write Count, Key, and Data Next Track 
Write Update Data 
Write Update Key and Data 


continued 
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Cc Table 3-1. Commands (continued) 


Command VO : 
Word Command Command Paragraph 
Grouping Word (Hex) Code Number 


Search Commands | Search Home Address Equal 
Multitrack Search Home Address Equal 
Search ID Equal 
Multitrack Search ID Equal 
search ID High 
Multitrack Search ID High 
Search ID Equal or High 
Multitrack Search ID Equal or High 
Search Key Equal 
Multitrack Search Key Equal 
Search Key High 
Multitrack Search Key High 
Search Key Equal or High 
Multitrack Search Key Equal or High 


Diagnostic | Diagnostic Write Home Address 
Commands Diagnostic Sense/Read 
Diagnostic Read Home Address 
Diagnostic Control 
Diagnostic Write 
Perform Subsystem Function 
 S Read Configuration Data 
Read Subsystem Data 
Test I/O" 


* Automatically generated by the channel when it requires status information. 
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Table 3-2. CSW Unit Status Definitions 


Bit in CSW Bit in Unit 
Status 


Attention — Indicates a Ready status when set in conjunction with Bits 5 and 7. 


Status Modifier — When set, this bit: 

(a) Modifies Bit 6 (Unit Check) to indicate than an unusual condition exists 
and that the last command must be retried. 

(b) Modifies Bit 3 (Busy) to indicate that the SP is Busy. 

(c) Modifies Bit 5 (Device End) to indicate that the sequence of commands 
is modified (the next CCW has been skipped). This condition generally 
results from successful completion of a Search command. 


Control Unit End — When set, this bit indicates that the SP status changed 
from Busy to available. 


Busy — When this bit is set and Bit 1 is reset, this bit indicates that the drive 


or volume is Busy. If Bit 1 is also set, this bit indicates that the SP is Busy. 


Channel End — When set, this bit indicates completion of data or control in- 
formation transfer to or from the channel. 


Device End — When set, this bit indicates completion of a device operation. 
If this bit, Bit 0, and Bit 7 are set, the drive or volume ts now at a Ready 
status and can accept communication from the SP. 


Unit Check — When set, this bit indicates that the SP or device has detected | ) 
a malfunction. 


Unit Exception — When set, this bit indicates the detection of an end of file 
on the addressed track during either 1) a Read Record 0, Read IPL, or Read 
Count, Key, and Data, or, 2) a Write Key and Data or Write Data. This bit can 
indicate a Ready status if Bits 0 and 5 are also set. 
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€ 3.2 Define Extent 
Command Code 63 (hex) 


This command transfers 16 bytes of parameters from the channel to the 3898-2. These 
parameters define limits on operations that follow, and provide a block size value for the 
channel program. The command resets orientation in the storage path. 


Parameters of the Define Extent command are listed below. The significance of bit 
settings within each of the 16 bytes is defined in Table 3-3. 


Byte Parameter 

O: - Mask byte 

l Global attributes 

2-3 Block size in bytes 

4—5 Not used 

6 Reserved — must be 0 

7 Not used 

8-11 Beginning of extent address 
12—15 End of extent address 


The 3898-2 verifies the parameters and reserved fields in sequence from Byte 0 through 
Byte 15 except that it checks Byte 1, bits 0 and 1 first to determine that the mode is 
correctly set to indicate Extended Count, Key, and Data (ECKD). If an exception 
Cc condition is encountered in more than one parameter, only the first exception is reported. 
| If the channel sends fewer than 16 bytes, the command is rejected with Unit Check 
ending status and subsequent sense data reports Command Reject with Format 0, 
Message 3 (CCW Count is less than required). 


Channel End and Device End are presented after parameters are transferred and 


checked for validity. If parameters are invalid, Channel End, Device End, and Unit 
Check are presented. 


Data Address — Defines main storage location of first parameter byte. 

Flags — Used at the programmer’s discretion. 

Count — 16 

Initial Status — Normally 0. 

Chaining Requirements — If Define Extent is used in the domain of a Locate Record 
command, it is terminated with Unit Check ending status. Subsequent sense 
information reports Command Reject with Format 0, Message 2 (Invalid Sequence). In 


addition, the command is rejected with the same ending status and sense data if 
preceded in the same CCW by a Define Extent, Space Count, or Set File Mask command. 


C 
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Table 3-3. Define Extent Parameters 


Mask Byte 
Function 


Write Control — Specifies the types of write opetations 
allowed in the CCW. 


0-1 Write Home Address and Write Record 0 inhibited. 
Permits all other Write operations. 


All Write commands inhibited. 
Only Update Write operations permitted. 
Ail.Write operations permitted. 
2 Reserved. 

Must be set to 0. If not 0, Define Extent is rejected with 
Unit Check and sense data reporting Command Reject 
with Format 0, Message 4 (Data Value not as required). 

3-4 Seek Control — Specifies which Seek commands and 
multitrack head switching operations are permitted 
outside the domain of a Locate Recordcommand. These Fo 
constraints have no effect on CCWs operating within the ( = 


domain of a Locate Record command. 


All Seek commands and the Aecalibrate command 
permitted. Ja 


Only Seek Cylinder and Seek Head commands permitted. 
Only Seek Head commands permitted. 
All Seek commands and multitrack operations inhibited. 


5-6 Access Authorization — Specifies an access 
authorization for channel program operations. 


Normal Authorization. Inhibits access to diagnostic or 
device support tracks. 


Device Support Authorization. Allows access to all tracks 
in all track groups. Also, these channel programs can 
perform all Locate Record operations. Certain operations 
require this access authorization. 


continued 
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Cc Table 3-3. Define Extent Parameters (continued) 
[sre [Sane | ox [ovum [ountane 


Mask Byte 
Function 


Diagnostic Authorization. Allows access to the diagnostic 
tracks only. This authorization inhibits the retry and cor- 
rection of Data Checks unless the check occurs in a 
Home Address field. 


Device Support Authorization with Inhibit Data Check 
Retry and Correction. Except during execution of a Read 
Home Address or Diagnostic Read Home Address com- 
mand, the 3898-2 inhibits retry and correction of any data 
checks encountered while sending data to the channel by 
one of the read commands. This authorization does not 
inhibit retry and correction if reading Home Address or 
during a search operation. 


PCi (Program-Controlled Interrupt) Fetch Mode — 
Specifies whether or not the mode is active. 


PC] Fetch Mode inactive 


PCI Fetch Mode active. In this mode, the channel pro- 
gram terminates with Unit Check ending status whenever 
channel command retry recovers from an exception con- 
dition tor a read command and at least one byte of data 

has transferred to the channel. 


Note: Host programs using PCI Fetch Mode access data 
being read before ending status is presented for the read 
command. If the retry results in sending valid data to the 
channel, the host program still needs to be notified that it 
may have accessed data that may not have been valid. 
Therefore, if the PCI Fetch Mode bit in the file mask Is set 
to 1, the read command that was retried is teminated with 
Unit Check ending status. if retry was unsuccessful, the 
channel program is terminated with Unit Check status. 


continued 
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Table 3-3. Define Extent Parameters (continued) 


[oe [emu [fee [ome 


1 Global Attributes Global Attributes Function — Defines global attributes of 
operations in the channel program. 


ECKD Mode. The 3898-2 supports only the ECKD mode 
of the Define Extent command. Any other setting in these | 
bits causes termination and Unit Check ending status. 
Sense information reports Command Reject with Format 
0, Message 4 (Data Value not as required). 


Count, Key, and Data (CKD) Conversion Mode. Not used 
in this subsystem and bit 2 must be 0. 


Subsytem Operation Mode. Not used in this subsystem 
and must be 000 to indicate that the subsystem operates 
as anormal cache replacement. 


Cache Operations. Not used in this subsytem and must 
be set to 00. 


2-3 Block Size Block Size in bytes — Specifies a value defining the 
average number of bytes for a single record in the : 
channel program. A zero value is also valid; it is ( 
interpreted as specifying the maximum reco.-J length that 
the device supports. Maximum record length is 8 (Count 
field) plus the value in Bytes 44 and 45 of the Head ' 
Device Characteristics command ({i.e., BB7C). wa 


When a subsequent Locate Record command contains a 
update write type of operation without a transfer length 
factor, the block-size value must be the exact data length 
(or sum of key and data lengths if the Key field is to be 
updated) of each record in the Locate Record domain 
(see Locate Record Operation Codes, Write Data). 


The correct block-size value depends on the area of the 
record that is to be sent. The value must be one of the 
following: 

« the data length (DL) 

* the key and data lengths (KL + DL) 

¢ the sum of KL and DL plus 8 (for the Count field). 


if the block size value exceeds the device’s track 
capacity (maximum Record 0 length), the command is 
rejected with Unit Check ending status. Sense 
information reports Command Reject with Format 0, 
Message 4 (Data Value not as required). The 3898-2 
does not check the block-size value except as necessary 
for update writes. 


continued 


3-8 3890-2.01-00 — 09/90 


— 


a Sa rate a: 
Define Extent Parameters (continued) 


Table 3-3. Define Extent Parameters (continued) 


alae To ame =— 


Cache Fast Write Identifier — Not used by this-subsys- 
tem and must be ‘00’ 
Reserved. Must contain zeros. If not zeros, the command 
is rejected with Unit Check ending status. Sense informa- 
tion reports Command Reject with Format 0, Message 4. 
Not Used. This byte is ignored. 
Beginning of Extent Address — Specifies the address 
Beginning Extent (CCHH format) of the first track in the extent. CCHH must 
Address be a valid track address for the device, specifically: 
« If the mask byte setting is Normal Authorization (bits 
5 and 6 are ‘00’), CCHH must be a primary or an 
alternate track address. 
« lf the mask byte setting is Diagnostic Authorization 
(bits 5 and 6 are ‘10’), CCHH must be a diagnostic 
track address. 
- If the mask byte setting is Device Support 
ees authorization (bits 5 and 6 are ‘01’ or ‘11’), CCHH 
UES can be any valid track address. 
If the address Is invalid, the Define Extent command is 
rejected with Unit Check ending status. Sense informa- 
cc tion reports Command Reject with Format 0, Message 4. 
End of Extent Address — Specifies the address (CCHH 
format) of the last track in the extent. CCHH must be 
Ending Extent equal to or greater than the value specified for the “begin- 
Address ning extent address” in Bytes 8 through 11. The track ad- 
dress must be valid for the access authorization specified. 
If CCHH is an invalid track address, the command ts 
rejected with Unit Check ending status. Sense informa- 
tion reports Command Reject with Format 0, Message 4. 
Note: With Device Support Authorization, device support 
tracks and other tracks can be accessed within the same 
extent. Because write operations are inhibited on such 
tracks, any access to a device support track in the same 
chain will be write-inhibited. 
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3.3 Locate Record 


Command Code 47 (hex) 


This command transfers 16 bytes of parameters from main storage to the SP. The Locate 
Record command resets orientation in the SP and establishes the orientation state 
specified by the Orientation and Operation byte parameter before any data transfers to 
or from the device. The parameters specify the type of operation, location, and number of 
records to be processed. The SP verifies the parameters and reserved fields in order from 
Byte 0 through Byte 15, except that it checks bits 2 through 7 of Byte 0 first. If the SP 
detects an exception condition in more than one parameter, it reports only the first 
exception. 


The SP presents Channel End status after it validates the parameters. It presents 
Device End after it completes track and sector positioning of the device. 


The Locate Record parameters, shown in Figure 3-1, are as follows: 
Byte Name and Significance 


0 Orientation and Operation Byte — Specifies the orientation to establish 
when track access is complete. It also specifies the operations to perform in 
the Locate Record domain. (Further details on the specifications for this 
parameter byte are provided in Table 3-4 and Section 3.3.2, Locate Record 
Operation Codes.) 


1 Auxiliary Byte — Used for verifying optional! fields in the Locate Record 
parameter list. 


¢ BitO=0. Bytes 14 and 15 are not used. 


¢ Bit0=1. Bytes 14 and 15 contain the transfer length factor that overrides 
the block size parameter in the Define Extent command. 


¢ Bits 1-6. These bits are reserved and must be zeros. 
¢ Bit 7=0. No Read Count as the last CCW in the Locate Record domain. 


¢ Bit 7 = 1. Specifies that the last data transfer CCW in the Locate Record 
domain is a Read Count CCW. The record it processes is included in the 


count of records to be processed as specified by the count parameter, Byte 
3. 


The Read Count CCW suffix is only valid for a Locate Record command that 
specifies Write Data (01) or Read (16) operations. If this suffix is 

specified for any other code, the command is rejected with Unit Check ending 
status. Sense bytes contain Command Reject with Format 0, Message 4 
(Data Value not as required). 


2 Reserved. Must always contain zeros. If not, the command is rejected with 
Unit Check ending status (sense bytes report Format 0, Message 4). 
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Locate Record Command Parameters 


Orientation 
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Read Track (OC 
Read (16) 


Figure 3-1. Locate Record Command Parameters 
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Byte Name and Significance 2 


3 Count — Determines the domain of the Locate Record command. This 
parameter specifies the number of records or tracks to be processed by 
the data transfer command following Locate Record. = 


Specific use of this parameter depends on the operation code in Byte 0 

(see 3.3.2, Locate Record Operation Codes). When the operation code is 

Orient (00), the count must be zero. For any other valid operation code, 

the count must not be zero. If Read Count CCW suffix is set to ‘1’ (Byte 1, bit 7), 
the count must be greater than 1. If the count parameter is not valid, the 
command is rejected with Unit Check ending status (sense bytes report 

Format 0, Message 4). 


Note: The 3898-2 dées not present an error if the count parameter is greater than 
the number of records or tracks transferred before the end of chain ina 
Locate Record domain. However, the user should ensure that the count 
parameter is correct to avoid possible Unit Check conditions that an 
incorrect count might cause in future product. 


4—7 Seek Address — Bytes 4 through 7 specify a seek address (CCHH) and 
must be a valid address for the device. If the seek address is not valid, 
the command is rejected with Unit Check ending status (sense bytes report 
Format 0, Message 4). 


If the seek address is not in the extent defined in the preceding Define Extent : 
command, the command is terminated with Unit Check ending status J 
(File Protected in Sense Byte 1). 


8-12 Search Argument — Bytes 8 through 12 contain the search argument 
(CCHHR) for the Locate Record search operation. When the operation 
(Byte 0) does not need orientation to a specific record, Bytes 8 through 12 
are ignored and no search takes place. When Home Address orientation is 
specified, Byte 12 (R) is ignored. 


13 Sector Number — Contains a sector number value. This value represents 
the actuator’s angular position on the track at which the SP should establish 
orientation. The sector number must be valid for the device. If invalid, the 
command is rejected with Unit Check ending status (sense information reports 
Command Reject with Format 0, Message 4. 


An ‘FF’ value is valid and specifies that sector positioning is not to be 
performed before the SP establishes channel connection and device 
onentation. 


14—15 Transfer Length Factor — The SP uses the transfer length factor to 
determine the number of data bytes to request from the channel for each 
Write CCW that follows a Locate Record specifying Write Data (01). The 
product of the value in Bytes 14 and 15 and the count parameter determine 
the total number of bytes to be sent in a Locate Record domain specifying 
Format Write (03), Write Track (OB), or Read (16). 


3-12 3890-2.01-00 — 09/90 


Locate Record Command Processing 


3.3.1 


The SP does not retain the transfer length factor after the end of the 
Locate Record domain. If a transfer length factor is not specified in the 
Locate Record command, the SP uses the block size parameter value in the 
Define Extent command for the data transfer length. 
Unit Check ending status with the sense bytes containing Command Reject with Format 
0, Message 4, occurs for the following situations: 


e Byte 1, bit 0 = 0 and Bytes 14 and 15 do not contain zeros. 


¢ Byte 1, bit 0 = 1 and Bytes 14 and 15 do not contain a transfer length factor. Bytes 
14 and 15 must not be a zero value. 


¢ The transfer length factor is more than the value specified, or implied, in the block 
size parameter of the Define Extent command. 


Locate Record Command Processing 


Each operation specifies the number and type of data transfer commands that the Locate 
Record domain expects and allows. If any other command sequence is in the Locate 
Record domain, that command is rejected with Unit Check ending status. Subsequent 
sense information reports Command Reject with Format 0, Message 2 (Invalid Sequence). 


When operating with the device, the Orientation and Search operations specified in the 
Locate Record parameters are performed during the read, write, or search CCW that 
follows the Locate Record command. Any exception condition that is encountered during 
these operations is reported in the ending status for that CCW. 


Search Operation — Certain operations need orientation to a specific record or record 
area before data transfer starts. Orientation is performed by a Search operation which 
occurs as follows, depending on the orientation required: 


¢ When specifying Index orientation, the device positions to Index and no Search 
operation is performed. 


* When specifying Count or Data field orientation (Byte 0, bits 0 and 1 are ‘00’ or 
‘10’), the search argument value (Bytes 8 through 12) is compared with the Count’s 
record ID field in each record, including Record 0, after the device is at the proper 
sector. When the Search operation starts, it continues until an equal comparison 
occurs, or until all record IDs on the track have been processed. If no record ID on 
the track compares equal to the search argument, the command is terminated 
with Unit Check ending status (No Record Found). 


¢ If the seek address parameter (Bytes 4 through 7) specifies a track that is marked 
defective (Home Address flag byte, bits 6 and 7 are ‘10’), the Search operation is 
performed on the assigned alternate track. If an alternate track is not assigned, or 
if an invalid alternate track is assigned, the command is rejected with Unit Check 
status (Improper Alternate Track Pointer). 


¢ When specifying Home Address orientation (Byte 0, bits 0 and 1 are ‘01’), the 
search argument value (Bytes 8 through 11 only) is compared with the track 
address field in the Home Address. If the track does not. have a Home Address, 
the command is terminated with Unit Check ending status. In this case, the sense 
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information is Data Check for the specific device. If the comparison is unequal, 
the command is terminated with Unit Check status (No Record Found). 


¢ The Home Address Search operation is performed on the track specified in the 
seek address parameter, even if that track is marked defective. 


Locate Record Operation Codes 


Orient (00) — With the Orient code specified, the SP positions the device according to 
the seek, search, and sector values indicated in Bytes 4 through 13 (see Table 3-4). Bytes 
3, 14, and 15 must be set to zero. When the device is at the proper sector, the Search 
operation occurs as described in 3.3.1, Locate Record Command Processing. 


The Locate Record domain ends when the track accessing or Search operation completes. 
Although the Search operation is performed after the following CCW is received, the 
following CCW operates outside the domain of the Locate Record command. 


Write Data (01) — This operation code prepares the SP to updata write to one or more 
consecutive user data records. The search argument parameter specifies the first record 
and the count parameter defines the number of records to update. This operation can 
also update the Key and/or Data fields of Record 0 when the search argument is set equal 
to the record ID in the Record 0 Count field. 


The SP uses the seek address and sector number parameters to start track access. When 
track access completes, the Search operation specified by the search argument and the 
orientation modifiers (Byte 0, bits 0 and 1) is performed. 


If bit 7 = 0 in the Auxiliary byte parameter (Byte 1), the Locate Record command must be 
followed by the number of Update Write commands specified by the count parameter. If 
bit 7 = 1, the Locate Record command must be followed by one fewer number of Update 
Write commands than the value specified in the count parameter. Also, the last Update 
Write command must be followed by a multitrack Read Count command. 
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Table 3-4. Locate Record Command Parameters 


Operation 
Code - 
Bits 2-7 ~ 
Byte 0 Byte 1 Byte 2 Byte 3 Bytes 4-7 | Bytes 8-12 Byte 13 | Bytes 14-15 


00 0000 Zero Zero Zero Seek Search Sector Zero 
Orient address argument number 


00 0001 Bit O = 1 Zero Count. Seek Search Sector Transfer 
Write Data | Bits 1-6=0 No. of address argument number | length factor. 
Bit7=0 records No. of bytes 
Bit 7 = 1 to Process to transfer 
Count = 1 


00 0011 
Format Write 


Zero Zero Count. Seek Search Sector Transfer 
No. of address argument number length 
Format factor. 
cmds. to No. of bytes 
process to transfer 
Zero Zero Count. Seek Search Sector Zero 
No. of address argument number 
records 
to process 


00 0110 
Read Data 


Zero Count. Seek Search Sector Transfer 
No. of address argument number length factor. 
records (Ignored) | No. of bytes 

to process to transfer 


00 1100 Zero Count. Seek Search Sector Zero 
Read Track No. of tracks | address argument number 
to process 
010110 Bro=1 Zero Count. Seek Search Sector Transfer 
Read Bits 1-6=0 No. of address argument number _ | length factor. 
Bit 7=0 records No. of bytes 
Bit 7 = 1 to Process to transfer 
Count = 1 


When count orientation is specified and one Update Write command is required, the 
Locate Record command must be followed by one of the following commands: 

¢ Write Data 

¢ Write Update Data 

¢ Write Key and Data 

¢ Write Update Key and Data. 


When more than one Update Write command is required, the Locate Record command 
must be followed by either a Write Update Data or Write Update Key and Data command. 
These two commands cannot both occur in the same Locate Record domain. 
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Similarly, when data orientation is specified, the Locate Record command must be 
followed by either a Write Update Data or Write Update Key and Data command and they 
cannot both occur in the same Locate Record domain. 


If a multitrack operation continues after the last record on a track, the SP advances to 
the next track and updates the first user data record on the next track. If the next track 
does not a contain a user data record, the command is terminated with Unit Check 
ending status (No Record Found). 


The transfer length factor, or the block size parameter value from a Define Extent 
command if the transfer length factor is not specified, must be equal to the actual record 
length of the records to update. The actual record length is either the data length (DL) or 
the sum of the key and data lengths (KL + DL), depending on whether the following 
write commands specify Write Data or Write Key and Data. If the actual length of any 
record to update differs from the transfer length factor (or block size) value, the 
command is terminated with Unit Check ending status (Invalid Track Format) and the 
record is not updated. 


If Bytes 4 through 7 specify a track in the device support address space, the command is 
rejected with Unit Check status (Command Reject, Format 0, Message 4). 


If the file mask inhibits all Write operations (bits 0 and 1 are ‘01’), the command is 
rejected with Unit Check ending status (Command Reject, Format 0, Message 2). 


In the Locate Record command, if Read Count CCW suffix (Byte 1, bit 7) is set to ‘1’, the 
count must be 1. If this condition is not met, the command is rejected with Unit Check 
status (Command Reject with Format 0, Message 4). 


If end of track occurs in a record, the command is terminated with Unit Check status 
(Invalid Track Format). 


Format Write (03) — This operation code prepares the SP to format one or more 
consecutive user data records. The count parameter defines the number of records to 
format. This operation can also format Home Address and/or Record 0 when Index or 
Home Address orientation is specified. After the last record is written on each track, the 
remaining portion of each track is erased. 


The SP uses the seek address and sector number parameters to start track access. If 
specifying Index or Home Address orientation, a sector value of zero is used for track 
access — the sector number parameter (Byte 13) is not used. When track access 
completes, the SP orients the device according to the orientation modifiers (Byte 0, bits 0 
and 1). 


The Locate Record command must be followed by the number of Format Write commands 
that are specified in the count parameter. Command sequence requirements for these 
commands are as follows: 


¢ When specifying Index orientation, Locate Record can only be followed by a 
Diagnostic Write Home Address command. 


¢ When specifying Home Address orientation, only a Write Home Address or Write 
Record 0 command can follow Locate Record. 
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¢ When specifying Count field orientation, only a Write Count, Key, and Data 
= command can follow Locate Record. 


e A Diagnostic Write Home Address or Write Home Address command can only be 
followed by a Write Record 0 command. 


e A Write Record 0 command can only be followed by a Write Count, Key, and Data 
command. If the Write Record 0 command assigned an alternate track, no Formal 
Write command can follow. 


¢ A Write Count, Key, and Data command can only be followed by another Write 
Count, Key, and Data command or a Write Count, Key, and Data Next Track 
command. 


¢ A Write Count, Key, and Data Next Track command can only be followed by a 
Write Count, Key, and Data or a Write Count, Key, and Data Next Track command. 


If a Format Write command in the domain of a Locate Record command does not.meet 
the sequence requirements, the command is rejected with Unit Check ending status 
(Invalid Sequence). 


If Home Address orientation is specified (Byte 0, bits 0 and 1 are ‘01’), the file mask must 
permit writing Home Address and Record 0. If Index orientation is specified (Byte 0, bits 
0 and 1 are ‘11’), the file mask must permit writing Home Address and Record 0 and 
must also specify Device Support Authorization. If the file mask does not permit writing 
Home Address and Record 0 (bits 0 and 1 are not ‘11’), the command is rejected with Unit 
Check status. The sense bytes contain Command Reject with Format 0, Message 4 (Data 
Value not as required). If the file mask does not specify Device Support Authcrization 
(bits 5 and 6 are not ‘01’ or ‘11’), the command is rejected with Unit Check status and the 
<= sense bytes report the same error information. 


If Count field orientation is specified (Byte 0, bits 0 and 1 are ‘00’), the file mask must 
allow Format Write operations. If the file mask does not permit Format Write operations 
(bits 0 and 1 are ‘01’ or ‘10’), the command is rejected with Unit Check status. The sense 
data reports Command Reject with Format 0, Message 2 (Invalid Sequence). 


If Bytes 4 through 7 (seek address) select a track in the device support address space, the 
command is rejected with Unit Check status. Sense data contains Command Reject with 
Format 0, Message 4. 


If the SP determines that there is not enough space on the track to write a record, the 
command is terminated with Unit Check ending status (Invalid Track Format). A 
partial record may be left on the track. The residual count in the CSW will not 
necessarily show the amount by which the record length exceeded the available space on 
the track. 


Read Data (06) — With this code specification, the SP sends one or more records (Home 
Address and Record 0 can be included) to the channel. The count parameter specifies the 
number of records to read. 


The SP uses the seek address and sector number parameters to start track access. When 
track access completes, the Search operation specified by the search argument and the 
‘orientation modifiers (Byte 0, bits 0 and 1) is performed. 
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The Locate Record command must be followed by the number of read CCWs needed to 
process the number of records specified by the count parameter. The Read Multiple 
Count, Key, and Data, Read Track, Diagnostic Read Home Address, and Read IPL 
commands are not valid in the domain of a Locate Record command. Any other sequence 
of Read commands is valid. If the Locate Record domain contains an invalid conrmand 
sequence, the invalid command is rejected with Unit Check ending status. -The sense 
information contains Command Reject with Format 0, Message 2 (Invalid Sequence). 


If the operation continues after the last record on a track has been read, processing 
continues according to the state of bit 0 (multitrack) in the Read command code. If end of 
track occurs in a record, the command is terminated with Unit Check ending status 
(Invalid Track Format). 


Write Track (0B) — This operation prepares the SP to Update Write the Record 0 Data 
field and format the rest of the track. The number of records to format is one less than 
the value specified in the count parameter. After the last record is written on the track, 
the remaining portion of the track is erased. If the value in the count parameter is ‘1’, 
only the Data portion of Record 0 is written and the remaining portion of the track is 
erased. 


The SP uses the seek address parameter and a sector value of zero to start track access; 
the sector number parameter (Byte 13) is not used. If the seek address parameter (Bytes 
4 through 7) specifies a track that is marked defective (Home Address flag byte, bits 6 
and 7 are ‘10’), the operation is performed on the assigned alternate track. If an 
alternate track is not assigned, or if an invalid alternate track is assigned, the command 
is rejected with Unit Check status (Improper Alternate Track Pointer). 


When track access completes, the SP is oriented to Home Address. It then compares the 
search argument with the record ID field in the Record 0 Count field. If no Home Address 
is on the track, the command is terminated with Unit Check ending status. The sense 
data reports Unit Check for the specific device. 


If Bytes 4 through 7 specify a track in the device support address space, the command is 
rejected with Unit Check status (Command Reject, Format 0, Message 4). 


If the file mask inhibits Format Write operations (bits 0 and 1 are ‘01’or ‘10’), the 
command is rejected with Unit Check ending status (Command Reject, Format 0, 
Message 2). 


Unit Check ending status with the sense bytes reporting No Record Found occurs if: 


¢ The track does not contain a Record 0 


¢ The search argument compares unequal to the record ID field in the Record 0 
Count field. 


The Locate Record command must be followed by one Write Data and a number of Write 
Count, Key, and Data commands that is one less than the value in the count parameter, 
with the following exceptions: 


e An Erase command can be substituted for the last or only Write Count, Key, and 
Data command in the Locate Record domain. 
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e Ifthe count parameter contains a value of 1, no Erase or Write Count, Key, and 
Data commands can follow the update data command. In this case, the remaining 
portion of the track is erased after the Record 0 Data field is updated. 


If a command in the Locate Record domain does not meet the sequence requirements, 
that command is rejected with Unit Check ending status. The sense data contains 
Command Reject with Format 0, Message 2. 


The Record 0 data length must be 8 bytes. If not 8 bytes, the command is terminated 
with Unit Check ending status (Invalid Track Format). 


Unit Check ending status, with sense bytes reporting Invalid Track Format also occurs if 
the SP determines that there is not enough space on the track to write a record. A 
partial record may be left on the track. 


When Invalid Track Format occurs, the CSW residual count may not show the amount 
by which the record length exceeded the available space on the track. 


Read Track (0C) — With this code specification, the SP sends all records from one or 
more consecutively addressed tracks to the channel. Data transfer starts with the first 
record (including Record 0) following orientation specified by the search argument and 
orientation modifier parameters. The count parameter specifies the number of tracks to 
use. 


The SP uses the seek address and sector number parameters to start track access. When 
track access completes, the Search operation specified by the search argument and the 
orientation modifiers (Byte 0, bits 0 and 1) is performed. 


The Locate Record command must be followed by the number of Read Track commands 
specified by the count parameter. Any other command series in the domain of the Locate 
Record command is invalid and that command is rejected with Unit Check ending status. 
The sense information contains Command Reject with Format 0, Message 2 (Invalid 
Sequence). 


The first Read Track command in the Locate Record domain causes the SP to orient to 
the first Count field (including Record 0) following the orientation that the Locate Record 
command establishes. The SP then sends each Count, Key, and Data field on the track 
until the end of the track is reached. 
The second and subsequent Read Track commands cause the SP to: 

1. Go to the next track. 

2. Orient to Home Address. 


3. Send each Count, Key, and Data field (including Record 0) on the track until 
the end of the track is reached. 


After the last record on the track transfers, a pseudo Count field of 8 bytes of ‘FF’ 
transfers to the channel. If the track does not have any records to transfer, the Read 
Track command sends only the pseudo Count field. 
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Note: The pseudo Count field can be used to locate the end of the track image 
character string in the host system’s main storage. The Read Track =) 
operation is for dump /restore utility programs to send all records from one 
or more tracks without first having to determine the number of records on 
each track and their formats. ; 


The operation can start with a record other than Record 0. Therefore, a Read Track 
operation that had an exception condition can be restarted at the point of interruption, 
rather than at the start of the track. 


If end of track occurs in a record read by a Read Track command that follows the Locate 
Record command, the command is terminated with Unit Check ending status (Invalid 
Track Format). 


Read (16) — This operation code prepares the SP to send one or more consecutive user ee 
data records to the channel. The count parameter defines the number of records to read. 

This operation can also be used to read Home Address and/or Record 0 when Index or 

Home Address orientation is specified. 


The SP uses the seek address and sector number parameters to start track access. If 

specifying Index or Home Address orientation, a sector value of zero is used for track 

access — the sector number parameter (Byte 13) is not used. When track access 

completes, the SP orients the device according to the orientation modifiers (Byte 0, bits 0 ae 
and 1). If specifying Home Address orientation and no Home Address is on the track, the = 
command is terminated with Unit Check ending status. The sense data reports Unit : 
Check for the specific device. 


If specifying Index or Home Address orientation (Byte 0, bits 0 and 1 are ‘01’ or ‘11’), a Jd 
Read Count command cannot immediately follow the Locate Record domain, or the 

commanzd is rejected with Unit Check ending status. The sense data reports Command 

Reject with Format 0, Message 4 (Data Value not as required). 


The Locate Record command must be followed by a sufficient number of Read commands 
(other than Read Track, Read IPL, or Read Multiple Count, Key, and Data) to read the 
number of records that are specified in the count parameter. If, in the Auxiliary byte 
parameter (Byte 1), bit 7 is set to ‘1’, the last operation in the Locate Record domain must 
be a multitrack Read Count operation. Command sequence requirements for Read 
commands following a Locate Record command are as follows. 


¢ All Read Commands except Diagnostic Read Home Address, Read Home Address, 
and Read Record O must be multitrack commands. 


e When specifying Index orientation, Locate Record can only be followed by a 
Diagnostic Read Home Address or a Read Home Address command. 


¢ When specifying Home Address orientation, only a Read Record 0 command can 
follow Locate Record. 


¢ When specifying Count field orientation, only a Read Data or Read Key and Data 
command can follow Locate Record. 
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¢ When specifying Data field orientation, only a Read Count, Read Key and Data, 
Read Data, or Read Count, Key, and Data command can follow a Locate Record 
command. 


¢ A Diagnostic Read Home Address or Read Home Address command can only be 
followed by a Read Record 0 command. - 


¢ A Read Record 0, Read Count, Read Key and Data, Read Data, or a Read Count, 
Key, and Data command can only be followed by a Read Count, Read Key and 
Data, Read Data, or Read Count, Key, and Data command. 


If a command in the domain of a Locate Record command does not meet the sequence 
réquirements, the command is rejected with Unit Check ending status (Invalid Sequence). 


If the operation continues after reading the last record on a track, the SP advances to the 
next track and reads the first user data record on the next track. If the next track does 
not have a uger’data record, the command is terminated with Unit Check ending status 
(No Record Found). If end of track occurs in a record, the command is terminated with 
Unit Check ending status (Invalid Track Format). 


Data Address — Defines the main storage location of the first byte of parameters. 
Flags — Used at the programmer’s discretion. 


Count — 16. The SP expects 16 bytes of parameters. If the channel sends fewer than 16 
bytes, the command is rejected with Unit Check ending status. The sense data contains 
Command Reject with Format 0, Message 3 (CCW Count less than required). 


Chaining Requirements — The Locate Record command is terminated with Unit 
Check ending status and the sense data reporting Command Reject with Format 0, 
Message 2 (Invalid Sequence) if it is encountered as follows: 


¢ This Locate Record command is in the domain of another Locate Record command. 


¢ A Define Extent or Read IPL command does not precede this command in the same 
channel program. 
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3.4 No-Operation (No-Op) J 
Command Code 03 (hex) 

This command is an immediate command resulting in no action at the drive level. 

Data Address — Not validated, but should not exceed addressing capacity. 

Flags — SLI flag must be set to avoid an incorrect length indication. 

Count — Must not be 0. A 0 count sets the Program Check bit (Bit 42) in the CSW. 


Initial Status — Channel End and Device End are posted. Because No-Op is an 
immediate command, initial status is treated as ending status. 


Special Requirements — This command is not valid within the domain of a Locate 
Record command. If inadvertently used with Locate Record, the command is rejected 
with Unit Check ending status. The sense information reports Command Reject with 
Format 0, Message 2 (Invalid Sequence). 


Indiscriminate usage must be avoided because this command resets orientation 
information. The reset results in a bypass of all or part of the record. For example: 


A No-Op between Read Count and Read Data for record n may cause the Data field of 
record n to be skipped and the Data field of record n+1 to be read. 


A No-Op between a command that reads the Data field of one record and a command that J 
must process the Count field of the next record (record n) may result in an overshoot of 
record n. The Count field of record n+1 may then be processed. 
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Command Code 07 (hex) — See paragraph 3.7. 


3.6 Seek Cylinder 


Command Code OB (hex) — See paragraph 3.7. 


3.7 Seek Head 


Command Code 1B (hex) 


Any one of the three Seek commands transfers the six-byte seek address to the SP. The 
Seek command and Seek Cylinder command are identical. Either command prompts the 
SP to select the drive and set the cylinder/track seek parameters for the drive. The Seek 
Head command also selects both the drive and the head, but accessing is not performed. 
These remarks summarize the operational differences and similarities for the three Seek 
commands. The description which follows applies to any Seek command. Limitations on 
address byte values for all devices are listed in Table 3-5. 


Given that cylinder switching is required, access motion is not initiated until a Set 
Sector, Read, Search, Write, Diagnostic Read Home Address, Diagnostic Write Home 
Address, or Space Count command is received in the chain or, if the CCW chain ends and 
the next command is one of the above. In the event that more than one Seek command is 
received in a CCW chain prior to the start of cylinder switching, only the last Seek 
command will result in a cylinder switch. 


Table 3-5. Address Byte Content and Specifications 


Seek Address J-Type Volume K-Type Volume 
Values Values 


Bytes 0, 1, and 4 


Bytes 2 and 3 (Cylinder Address) 


Byte 5 (Head Address) must not exceed 
CE Cylinder 886" 2658" 


Surface Analysis Cylinders -2,-3 2667-2669" 
(FFFE, FFFD)* 


Alternate Cylinders 885 2655 


CE use only. 
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Seek Head 


For all three Seek commands, Channel End and Device End are presented after the seek 
address has been transferred. Any Seek command resets track orientation information J 


in the SP. 


Data Address — Defines main storage location of the seek address. 
Seek Address — Checked for both validity and correct parity by the SP. The format for 
the seek address is OOCCHH (where CC is a cylinder address and HH is a head address). 
If an invalid seek address is noted, the command is not executed and the ending status 
shows Unit Check, Channel End, and Device End. In this case, a Command Reject 
(Invalid Argument) will be posted for the next Sense command. 


Flags — Used at the programmer’s discretion. 


Count — Must be 6. If the count is less than 6, command does not execute and the 
ending status shows Unit Check, Channel End, and Device End. ACommand Reject will 
be posted for the next Sense command. If the count is greater than 6, only the first 6 
bytes are transferred. 


Initial Status — Normally 0. 


Special Requirements — The Seek and Seek Cylinder commands do not require a 

preceding CCW. However, the programmer must precede the Seek Head command with 

a command that establishes cylinder orientation. If Set File Mask is issued prior to any es 
Seek command, the file mask must be set to allow seeks. If the file mask is not so set, ( , 
Unit Check is presented in the ending status. For Seek operations against a CE or 
surface analysis cylinder, the Seek command must be preceded by a Set File Mask 

command with file mask bits 5 and 6 set as indicated (see Table 3-6). J 


The Seek commands are not valid within the domain of a Locate Record command. If one 
is inadvertently used with Locate Record, the command is rejected with Unit Check 
ending status. The sense information reports Command Reject with Format 0, Message 
2 (Invalid Sequence). 


If the Seek Cylinder command was preceded in the channel program by a Define Extent 
command, and the seek address is outside the defined extent, the command is terminated 
with Unit Check ending status (File Protected). 
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© 3.8 Space Count 
Command Code OF (hex) : 


This command is used to space over an unreadable Count field in order to recover the 
Key and Data field of the record in question. For the Space Count command, three bytes 
of data are transferred to the SP. They are interpreted as the key length (first byte) and 
data length (last two bytes) of the record to be recovered. These three bytes of data define 
the key and data length that could not be read from the Count field. If the number of 
bytes is less than three, the remaining count is set to 0. 


Data Address — Defines main storage location of the key and data lengths of record to 
be recovered. 


Flags — Used at the programmer's discretion. 


Count — Must be 3 to transfer the requisite 3 bytes. If the count is less than 3, the 
specified number of bytes is transferred and the value of the untransferred bytes is 
assumed to be 0. Should the count exceed 3, only 3 bytes are transferred. Since the 
channel requires a nonzero value in the CCW count, SLI bit 34 should be set to avoid an 
incorrect length condition. 


fot In the event that the specified number of bytes to be transferred is less than 3, 
pe subsequent Read Data and Read Key and Data commands may result in Unit Exception. 
A Read Count, Key, and Data command may result in Data Check. 


c Chaining Requirements — Cannot be chained from a Format Write or Erase 
command. Must not be followed by a Write, Erase, Device Release, Device Reserve, Read 
IPL, or Set File Mask, in the same chain. Violation of these requirements will cause 
Channel End, Device End, and Unit Check to be presented to the channel. 


If this command is not preceded in the command chain by a Seek, Seek Cylinder, Locate 
Record, Read IPL, or Recalibrate, the command is rejected with Unit Check ending 
status. The sense information contains Command Reject with Format 0, Message 2 
(Invalid Sequence). 


If the Space Count command is chained from a Space Count, Read, Write, or Search 
command, it points to the start of the next Count field, the Count field is bypassed, key 
and data length are received from the channel, the End-of-Count field internal 
orientation indicator is set, and Channel End and Device End are presented to the 
channel. 


If the Space Count command is not chained from a Space Count, Read, Write, or Search 
command, it searches for Index, clocks through the Home Address, spaces over the 
Record 0 Count field, receives the key and data length from the channel, sets the 
End-of-Count field internal orientation indicator, and presents Channel End and Device 
End to the channel. 


This command is not valid within the domain of a Locate Record command. If 
inadvertently used with Locate Record, the command is rejected with Unit Check ending 
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status. The sense information reports Command Reject with Format 0, Message 2 
(Invalid Sequence). 


A faulty Record 0 Count field will be bypassed by a Space Count command followed by a 
Read Key and Data command. Record 1 can be read by Space Count followed by_a Read 
Data or a Read Key and Data command. This function can prove useful when attempting 
to recover the Record 0 Data field content or the whole of Record 1. 


The Key and Data fields of the record (n # 0) may be recovered by the following: Set 
Sector, Search ID (Record n -1), Transfer-in-Channel —8,* Space Count,** Read Key and 
Data. 


Record n+1 may be recovered by: Set Sector, Search ID (Record n —1), 
Transfer-in-Channel —8,* Space Count,** Read Count, Key, and Data. 


Transfers to the address of Transfer-in-Channel less 8. 


Correct key and data lengths must be stated. Unpredictable results, loss of track orientation, or Data Checks may 
result from requesting an incorrect length. 
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Recalibrate; Restore 


€ 3.9 Recalibrate 


Command Code 13 (hex) 


This command returns the track address to cylinder 0, head 0 from any setting. Channel 
End is presented as the ending status. Device End is presented when the recalibrate has 
executed. 

Data Address — Not checked for validity, but should not exceed addressing capacity. 
Flags — SLI flag must be set to avoid an incorrect length indication. 

Count — Must not be 0. A 0 count sets the Program Check bit (Bit 42) in the CSW. 


Initial Status — Normally 0. Not processed as an immediate command. 


Special Requirements — This command must be preceded by a Set File Mask 
command that allows seeks. 


If the Recalibrate command was preceded in the CCW by a Define Extent command, and 
cylinder 0, head 0 is not in the defined extent, the command is terminated with Unit 
Check ending status (File Protected). 

‘This command is not valid within the domain of a Locate Record command. If 
inadvertently used with Locate Record, the command is rejected with Unit Check ending 


Cc status. The sense information reports Command Reject with Format 0, Message 2 
(Invalid Sequence). 


3.10 Restore 


Command Code 17 (hex) 
This command is primarily used for compatibility with other direct-access storage 
devices. It is effectively a No-Op command and results in loss of orientation. Channel 
End and Device End immediately follow initial status. 
Data Address — Not checked for validity, but must not exceed addressing capacity. 
Flags — SLI flag must be set to avoid an incorrect length indication. 
Count — Must not be 0. A 0 count sets the Program Check bit (Bit 42) in the CSW. 
Initial Status — Normally 0. 
Special Requirements — This command is not valid within the domain of a Locate 
Record command. If inadvertently used with Locate Record, the command is rejected 


with Unit Check ending status. The sense information reports Command Reject with 
Format 0, Message 2 (Invalid Sequence). 
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Set File Mask 


3.11 Set File Mask 


Command Code 1F (hex) 


The command provides data protection by inhibiting/permitting execution of a particular 
Seek and Write command. These functions are accomplished by setting bits of a valid 
mask byte to predefined values, as indicated in Table 3-6. 


Bit 2 of the mask byte must be 0. If bit 2 is not 0, the mask byte is considered to be 
invalid, a Unit Check condition (CSW bit 38) is generated and Channel End and Device 
End are presented in the ending status. A subsequent Sense command indicates 
Command Reject. 


Commands that violate the file mask are not executed. In these cases, Unit Check is 
presented in the ending status, and either Command Reject (if a Write command) or File 
Protected (if a Seek command) is indicated by a subsequent Sense command. Multitrack 
operations that violate the file mask result in Unit Check and File Protected. 


The file mask defaults to ‘00’ at the beginning of every CCW chain. A Start I/O 
instruction issued without a Set File Mask command permits Seek and Write commands 
(except Write Home Address, Diagnostic Write Home Address, and Write Record Zero). 
Channel End and Device End are posted after the mask byte is transferred. 

Data Address — Defines main storage location of mask byte. 

Flags — Used at the programmer’s discretion. 

Count — 1. 


Initial Status — Normally 0. 


Special Requirements — Unit Check ending status with sense information reporting 
Command Reject with Format 0, Message 2 (Invalid Sequence) occurs if the command: 
¢ isin a Locate Record domain 


¢ was preceded in the same CCW by a Define Extent or another Set File Mask 
command. 


Chaining Requirements — Device Reserve or Device Release must not follow Set File 
Mask; if these commands appear in the same command chain, they must precede Set File 
Mask. Space Count must not precede the Set File Mask command. 


3-28 3890-2.01-00 — 09/90 


File Mask Bit Definitions 


Cc Table 3-6. File Mask Bit Definitions 


Write Home Address and Write Record 0 are inhibited. 
All Write commands are inhibited. 

All Format Write commands are inhibited. 

All Write commands are permitted. 


This bit is always set to zero. If this bit is not zero, the device presents a Unit 
Check in the CSW. 


All Seek commands are permitted. 

Seek Cylinder and Seek-Head are permitted (no full Seek). 
Seek Head is permitted. 

All Seek commands and head switches are inhibited. 


CE and surface analysis cylinder access is inhibited unless the channel program in 
question has special authorization. 
CE and surface analysis cylinder access is permitted. 
For channel programs with Diagnostic Authorization, access to the CE cylinder is 
permitted and all other access is inhibited. These restrictions apply regardless of 
whether the Seek operation precedes or follows the Set File Mask command. 

= CE and surface analysis cylinder access is permitted. However, retry and ECC 

i correction are only initiated for Read commands (except Read Home Address and 
Diagnostic Read Home Address) and Search commands. 


PCI Fetch Mode is inhibited. 
PCl Fetch Mode is permitted. If a Data Check occurs and a command retry 
recovers the data, PCI Fetch Mode presents a Unit Check. 


Use of bits 5 and 6 should be restricted to maintenance sessions. Any other use of these bits may yield unpredictable 
results. 


** This specification is not allowed for a 3890 device. 
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Set Sector 


3.12 Set Sector 


Command Code 23 (hex) 


3-30 


This command transfers a sector number (one byte) from main storage to the SP; valid 
sector numbers are 0-221 and 255. During a Set Sector, the drive signals the SP when 
the requested sector number is nearing the read/write head. The SP then signals the 
channel to proceed with the operation. If the channel does not respond, the SP waits for 
the next disk rotation to complete and renotifies the channel. This sequence continues 
until the channel responds. Set Sector is normally used on block multiplexer channels to 
eliminate the need to maintain ciannel and SP connection during rotational delays. 
Execution of Set Sector resets orientation information stored in the SP. 


The sector number is checked by the SP. One of three conditions may result: valid sector 
number (0-221), the sector number is greater than 221 and less than 255, or the sector 
number = 255. 


Sector Number between 0 and 221 — The SP presents Channel End. Device End is 
posted when the adjusted sector number is reached and the channel reconnects to 
continue the chain. If reconnection fails, the SP attempts reconnection during the next 
revolution. 


Sector Number between 222 and 254 — Channel End, Device End, and Unit Check 
are presented in the ending status. The next Sense command posts a Command Reject. 


Sector Number equals 255 — The command is handled as a No-Op command. The 
ending status shows Channel End and Device End. Track orientation is lost. 


Data Address — Defines main storage location of desired sector number. 
Flags — Used at the programmer’s discretion. 
Count — 1. 


Chaining Requirements — The Set Sector command must be preceded in the 
command chain by a command that specifies, or implies, cylinder and head parameters. 
If this command is not preceded in the command chain by a Seek, Seek Cylinder, Locate 
Record, Read IPL, or Recalibrate, the command is rejected with Unit Check ending 
status. The sense information contains Command Reject with Format 0, Message 2 
(Invalid Sequence). 


Set Sector does not ensure positioning. To accurately position the head, the programmer 
must issue a Search command against the desired records. For multitrack search 
operations, the most effective sequence is Set Sector (0), Read Home Address, Search 
(Multitrack). 


The Set Sector command is not valid within the domain of a Locate Record command. If 
inadvertently used with Locate Record, the command is rejected with Unit Check ending 
status. The sense information reports Command Reject with Format 0, Message 2 
(Invalid Sequence). 
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€ 3.13 Set Path Group ID 


Command Code AF (hex) 
This command transfers path group identification information (12 bytes) from main 
storage to the SP. The path group ID defines the System Control Program (SCP) that 
manages a channel grouping. Once a path group ID for a device has been established, the 
device is reserved to those channels having a common ID. Extended Architecture (XA) 
computer systems provide block reconnections on the first available path which is a 
member of that established group. System reset will reset the device reservation. When a 
Set Path Group ID command is received by the SP, the ID is checked to see if a path 
group ID has been set for this channel since the last system reset. If not, the path group 
ID is accepted. Given that a path group ID has been set, the ID is compared. If the ID is 
not equal, the command is rejected. Channel End and Device End are presented after the 
command is executed. 


The path group ID format is as follows: 
Byte 0 — Function Control Byte 
Bit 0=0 Single path mode (370 mode) 
1 Multiple path mode (XA mode) 


Bits 1-2=00 Establish group: Matching IDs (bytes 1-11) result in the SP forming 
< groups for the addressed device for all channel paths with the same ID. 


01 Disband group: A standalone path is established for the addressed 
device with every channel member of the path group that has the same 
ID. If a reservation existed for this channel group, it remains with 
this channel. 


10 Resign from group: Issuing channel becomes a standalone 
channel. If the addressed device was reserved to the group, the 
reservationcontinues with the remianing members of this group. 


11 Invalid 
Bits 3-7 Must be zero. 
Bytes 1-11 — SCP ID 


These bytes identify the system control program (SCP) and must not be all zeros. An 
all-zero setting results in a Command Reject when the sense information is returned. 
Under MVS, the SCP consists of bytes 1-6 of the CPU ID (STIDP instruction). These 
bytes contain the CPU model version, serial number, and model number. Bytes 1-6 of 
the CPU ID are followed by the first five bytes of the time-of-day clock (STCK 
instruction) as stored shortly after IPL. 
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Data Address — Defines main storage location where the first byte of path group ID 
information is to be stored. wa 


Flags — Used at the programmer's discretion. 

Count — 12. - 
Initial Status — Normally 0. 

Chaining Requirement — This command must be the only command in the chain. 


Special Requirements — The SCP may not expand or contract a path group while a 
CCW chain is in progress for the group. Lost interrupts, misdirected interrupts, or other 
unpredictable consequences will result. 

4 


If a path group is expanded, all devices reserved to the original path group are reserved 
to the expanded group. When a path group with multiple paths is contracted, all devices 
reserved to the original group are reserved to the contracted group. In the event that a 
path group is disbanded, all devices reserved to the original group are reserved to the 
channel that executed the disband function. 


When a system reset causes the path group ID for a channel! to be reset, reserved devices 

will be released if the resetting channel is the only member of the group. Multiple 

channel reserved devices will remain reserved to the channels that did not execute the rai 
reset. ( 
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Suspend Multipath Reconnection; Transfer-in-Channel (TIC) 


© 3.14 Suspend Multipath Reconnection 
Command Code 5B (hex) . 


This command inhibits channel program execution against a path other than the path on 
which the command was received. This command is primarily used for fault isolation 
when operating in a multiple path mode. The use of this command does not affect the 
existing path groups or the state of device reserves. When the command is executed, the 
channel program is restricted to a single path until final status for the command chain is 
presented and accepted by the channel. 


Channel End and Device End are presented after the command is executed. 

Data Address — Not used. 

Flags — Used at the programmer’s discretion. 

Count — Cannot be 0. A program check will be presented if count is 0. 

Initial Status — Normally 0. 
i Special Requirements — This command is not valid within the domain of a Locate 
(es: Record command. If inadvertently used with Locate Record, the command is rejected 


with Unit Check ending status. The sense information reports Command Reject with 
Format 0, Message 2 (Invalid Sequence). 


3.15 Transfer-in-Channel (TIC) 


Command Code x8 (hex) x 
This command provides chaining capabilities for noncontiguous CCWs. 


Data Address — Defines the main storage location of next CCW to be retrieved. Must 
not specify another TIC CCW. 


Flags — Ignored. 

Count — Ignored. (Only CCW that can have a 0 count.) 

Chaining Requirement — TIC cannot be the first CCW specified by the channel 
address word. Command execution does not initiate I/O operations or signal any device. 


When chaining requirements are violated or an invalid data address (not on a double 
word boundary) is specified, a Program Check is presented (Bit 42 in the CSW). 


c 
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3.16 Sense 


Command Code 04 (hex) 
This command transfers 32 bytes of sense information from the SP to the channel. This 
information describes Unit Check status, current status of the device that performed the 
operation, and system error recovery information. 


Channel End and Device End are presented after sense bytes are transferred. 


Data Address — Defines main storage location where first byte of sense data is to be 
stored. 


Flags — Used at the programmer’s discretion. 

Count — 32. 

Initial Status — 0. 

Special Requirements — This command is not valid within the domain of a Locate 
Record command. If inadvertently used with Locate Record, the command is rejected 


with Unit Check ending status. The sense information reports Command Reject with 
Format 0, Message 2 (Invalid Sequence). 


A Sense command Unit Check should always accompany regardless of wnether the sense 
information is used. This command resets track orientation information in the SP. 


A standalone Sense command, issued during a contingent allegiance, causes the SP to S| 
send error data to the channel. The recommended error recovery procedures assume 
that the Sense command is the only command in achain. If other commands are chained 
from the Sense command, the device may not accept them, which can cause 
unpredictable results. 


Note: This command was formerly Sense DQ. NO 
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C 3.17 Sense ID 


Command Code E4 (hex) 


This command transfers 12 bytes of sense information from the SP to the channel. This 
sense information describes controller and drive type (see chart below). Channel End and 
Device End are presented after sense bytes are transferred. 


Track orientation information is reset after the execution of this command. 


If the command is sent to a drive that is not ready, the drive type and model bytes (Bytes 
4—6) contain zeros. 


Data Address — Defines main storage location where first byte of sense data is to be 
stored. 


Flags — Used at the programmer’s discretion. 
Count — 12. 


‘Initial Status — Normally 0. 


os Special Requirement — This command is not valid within the domain of a Locate 

ie Record command. If inadvertently used with Locate Record, the command is rejected 
with Unit Check ending status. The sense information reports Command Reject with 
Format 0, Message 2 (Invalid Sequence). 


Drive Type Configuration Data 


CS eee 
9 per | ae | s0 | ce | so | ao | 16 | 00 | a0 | a | ot | oo 
Ty pf | a | oo | ce | oe | oo | ve | oo | ao | ea | ot | oo 


3890-2.01-00 — 09/90 3-35 


Sense Path Group ID 


3.18 Sense Path Group ID 


Command Code 34 (hex) 


This command transfers path group ID information (12 bytes) from the SP to main 


storage. 


The ID bytes are formatted as follows: 


Byte 0 — Path State Byte 


Bits 0—1 = 00 


01 


10 


11 


Bits 2-3 = 00 


01 


10 


11 


Bit 4=0 


1 


Bits 5-7 


The SP has not executed a Set Path Group ID command on the channel 
since the last system reset. 


Reserved. 


The channel has a valid ID and the addressed device is not part of 
a group. 


The channel has a valid ID for this device and the device is shared by 
a group. 


The selected device is not presently reserved. 


The selected device is not presently reserved but there is a contingent, 
or implicit allegiance, to another member of the path group (if one exists). 


The selected device is reserved for another channel. 


The selected device is reserved for this channel and for other members 
of the path group (if they exist). 


Single path mode (370 mode) 
Multiple path mode (XA mode) 


Set to 0. 


Bytes 1-11 — Path Group ID 


These bytes contain the current path group ID associated with the channel path issuing 
the command. They will contain all zeros if no Set Path Group ID command has been 
issued by this channel since the last system reset. If there is a valid ID for this channel, 
it will be in this field. 


3-36 
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Sense Path Group ID 


Cc Channel End and Device End are presented after the path group ID information has 
been transferred. 


Data Address — Defines main storage location where the first byte of path group ID 
information is to be stored. ~ 


Flags — Used at the programmer’s discretion. 
Count — 12. 
Initial Status — Normally 0. 


Special Requirement — This command must be the only command in the chain. 
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3.19 Sense Subsystem Status J 
Command Code 54 (hex) 


This command transfers the status of the subsystem (40 bytes) from the storage path to 
the channel. The transferred information describes the status of the 3890-2 subsystem 
and the addressed volume. After the transfer is complete, the SP posts Channel End and 
Device End as the ending status. 


This command is accepted even if the device is not ready. 


The status bytes and their significance are as follows: 


Bytes Significance 
0 Set to zeros. 
1 Device Unit Address of the channel program. 
2 Reserved — must be set to zeros. 
3 Number of Statistics Sets per Device — not used and set to zero. 
4 Overall Caching Status — not applicable and set to zero. 
5 Overall Nonvolatile Storage Status — not applicable and set to zero. 
6-9 Reserved — must be set to zeros. 
10—25 Cache Capacity information — not applicable and set to zeros. or. 
26-27 Device Caching Status — not applicable and set to zeros. 
28-36 Nonvolatile Storage Capacity and Device Status information — not applicable and 

set to zeros. | 
37 Reserved — must be set to zeros. J 
38-39 Subsystem Identifier (SSID) — Specifies the identifier for this subsystem. 


Data Address — Defines the main storage location where the first byte of status is to be 
transferred. 


Flags — Used at the programmer’s discretion. 


Count — 40. If the CCW count exceeds 40, only 40 bytes are sent. If the CCW count is 
less than 40, only the specified number of bytes are forwarded. 


Initial Status — Normally 0. 


Chaining Requirements — This command is not a valid command in the domain of a 
Locate Record command. Also, Sense Subsystem Status must be the first command in a 
chain or be chained directly from a Read Device Characteristics, a Read Configuration 
Data, or a Suspend Multipath Reconnection command. If chained directly from a 
Suspend Multipath Reconnection command, the Suspend Multipath Reconnection 
command must be the first command in the chain. If these requirements are not met, 
Sense Subsystem Status is rejected with Unit Check ending status. The sense 
information reports Command Reject with Format 0, Message 2 (Invalid Sequence). 


In addition, if any command is chained from the Sense Subsystem Status command, that 
command is rejected. The Sense Subsystem Status operation is not affected by the 
rejected command. 
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© 3.20 Device Reserve 


Command Code B4 (hex) 
This command reserves the addressed drive for the path group issuing the command. 
Reservation is maintained until a Device Release for the channel (or any channel in the 
path group) is successfully executed. A System Reset resets reservation of the device to 
the resetting channel only. In addition, 32 bytes of sense information are transferred 
across the channel to main storage. Track orientation is reset after the execution of this 
command. 


Channel End and Device End are presented after the 32 sense bytes are transferred. 
Data Address — Defines main storage location where sense bytes are to be transferred. 
Flags — Used at the programmer’s discretion. 

Count — 32. 

Initial Status — Normally 0. 

Special Requirements — Device Reserve must be the first command in the channel 

f program. If preceded by any other command, the Device Reserve command is rejected 
with Unit Check ending status. The sense data reports Command Reject with Format 0, 
Message 2 (Invalid Sequence). 

Device Reserve is an invalid command within the domain of a Locate Record command. If 
inadvertently used with Locate Record, the command is rejected with Unit Check ending 


status. The sense information reports Command Reject with Format 0, Message 2 
(Invalid Sequence). 
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Device Release 


Command Code 94 (hex) 
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This command releases the drive address reserved for the path group. In addition, 32 
bytes of sense information are transferred across the channel to main storage. 


Channel End and Device End are presented after sense byte transfer. 


Data Address — Defines main storage location where first byte of sense data is to be 
stored. 


Flags — Used at the programmer’s discretion. 

Count — 32. 

Initial Status — Normally 0. 

Special Requirements — Device Release is rejected with Unit Check ending status if 
preceded in a channel program by a Define Extent, Space Count, or a Set File Mask 
command. Sense data contains Command Reject with Format 0, Message 2 (Invalid 
Sequence). 

This command is not valid within the domain of a Locate Record command. If 
inadvertently used with Locate Record, the command is rejected with Unit Check ending 


status. The sense information reports Command Reject with Format 0, Message 2 
(Invalid Sequence). 
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© 3.22 Unconditional Reserve 


Command Code 14 (hex) 
This command provides all the functions of Device Reserve and also reserves the drive for 
an alternate path even if the drive is reserved or is in use through the original path. 
This command transfers 32 bytes of sense information to main storage via the channel. 
Channel End and Device End are presented after the 32 sense bytes are transferred. The 
Unconditional Reserve command resets track orientation in the SP. Command execution 
is halted if there is no response from the drive or if there is a Preselection Check. 


When an Unconditional Reserve command is issued to a device not assigned to the chan- 
nel, the following may occur on the unassigned system. 


e Ifthe device was reserved, the reservation is reset and the device becomes 
reserved to the channel that issued the Unconditional Reserve command. 


e Ifthe device is disconnected between chained commands, an interrupt will be lost. 


e If the device is active when the command is executed, a recoverable Equipment 
Check will be presented. 


¢ Ifthe device is idle and not reserved, there is no effect. 


If the system does not want the device reserved to the issuing path, it must issue a 
Device Release command. The Device Release command may be chained to the Uncondi- 
tional Reserve command. 


Data Address — Defines main storage location where first byte of sense data is to be 
stored. 


Flags — Used at the programmer’s discretion. 
Count — 32. 
Initial Status — Normally 0. 


Special Requirements — The Unconditional Reserve command must be the first 
command in a chain. 


This command is not valid within the domain of a Locate Record command. If inadver- 
tently used with Locate Record, the command is rejected with Unit Check ending status. 
The sense information reports Command Reject with Format 0, Message 2 (Invalid Se- 
quence). 


Unit Check ending status with the sense data containing Equipment Check with Format 
3, Message F (Allegiance Terminated) is sent to the channel when one of the following 
conditions occurs: 


¢ this command interrupts any I/O chain 


¢ the channel had a reservation for this device without also having an active 
command chain. The next Start I/O will have Unit Check status pending. 


¢ the channel had a Contingent Allegiance for the device and then sent a Sense 
. command for that device after the Unconditional Reserve command was received. 
oe Unconditional Reserve resets Contingent Allegiance for the affected device for all 


paths. 
Cc 
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Command Code 64 (hex) 
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Read Device Characteristics 


This command transfers device characteristics information (up to 64 bytes) from the SP 

to the channel. The information transferred by this command defines the characteristics 

of the addressed device. Given that the addressed device is neither busy nor in the ready >) 
state, Read Device Characteristics does not execute and Unit Check is posted in the 
initial status. When executing normally, the SP posts Channel End and Device End after 

the data has been transferred. 


The 64 bytes of device characteristics are as follows: 


Contents 


Controller Type 

Controller Model 

Device Type - 

Device Model 

Device and Controller Features 

Device Class Code 

Device Type Code 

Number of Primary Cylinders 

Number of Tracks per Cylinder 

Number of Sectors 

Total Track Length Usable for Data Records 
Length of Home Address and Record Zero 
Track Capacity Calculation Formula Code 
Track Capacity Calculation Factor 
Non-Keyed Record Overhead 

Keyed Area Overhead 

Address of First Alternate Cylinder 
Number of Alternate Tracks 

Address of First Diagnostic Cylinder 
Number of Diagnostic Tracks 

Address of First SA Cylinder 

Number of SA Tracks 

MDR Record Identification 

OBR Record Identification 

Controller Type 

Not Used 

Length of Record 

Not Used 


Data In Hex 
3890- 3890- 
J-Type K-Type 
3990 3990 
C2 C2 
3380 3380 
16 1E 
D0000003  D0000003 
20 20 
OE OE 
0375 OA5F 
O0OO0F -  OOOF Jo 
DE DE 
OOBB60 OOBB60 
0440 0440 
01 01 
20 20 
01EC 01EC 
O0EC O0EC 
0375 OA5F 
O0OF OOOF 
0376 OA62 
OOOF O00F 
FFFD OAG6B 
OOOF 002D 
21 23 
21 23 
06 06 
Zeros zeros 
BB74 BB74 
zeros zeros 
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Read Device Characteristics 


Data Address — Defines the main storage location where the first byte of device 
& characteristics information is to be transferred. 


Flags — Used at the programmer’s discretion. 

Count — 64. 

Initial Status — Normally 0. 

Special Requirement — This command is invalid within the domain of a Locate Record 
command. If inadvertently used with Locate Record, the command is rejected with Unit 


Check ending status. The sense information reports Command Reject with Format 0, 
Message 2 (Invalid Sequence). 
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Read and Reset Buffered Log 


3.24 Read and Reset Buffered Log 
Command Code A4 (hex) “é 


This command transfers 32 bytes of usage and error information from the SP to the 
channel. This information pertains to the SP addressed by the Start I/O instruction and 
the device identified in Byte 4. The counters are reset after the data transfer. 

The customer should note that the information transferred by this command is identical 


to the information transferred by a Sense command (04) after the usage or error counters 
overflow. 


Track orientation is reset after the execution of this command. 


Data Address — Defines main storage location where first byte of error or usage data is 
to be stored. 


Flags — Used at the programmer’s discretion. 

Count — 32. If the CCW count is greater than 32, only 32 bytes are transferred. If the 

CCW count is less than 32, the number of bytes specified is transferred. Channel End 

and Device End are presented after the data transfer. 

Initial Status — Normally 0. ‘a 
Special Requirements — This command is not valid within the domain of a Locate 

Record command. If inadvertently used with Locate Record, the command is rejected 


with Unit Check ending status. The sense information reports Command Reject with a 
Format 0, Message 2 (Invalid Sequence). 


& 
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Reset Allegiance 


© 3.25 Reset Allegiance 


Command Code 44 (hex) 
The Reset Allegiance command sends 32 bytes of data to the channel. It is used to 
terminate a device’s allegiance to a channel path or a path group, and operates even if 
the device is busy or not ready. Reset Allegiance does not, however, reset any allegiances 
if the device is reserved to another channel or path group. 


The SP presents Channel End after the data transfer completes and Device End when 
the operation completes. If the device is awaiting completion of an asynchronous 
operation, the SP presents Channel End to the Reset Allegiance command, disconnects 


from the channel until the asynchronous operation completes, and then presents Device 
End. | 


The significance of bits in Byte 0 are defined below. Bytes 1 through 31 of the data sent 
to the channel are zeros. 


Byte 0 
Bits Significance 
0 1 = Device selection successful. 


When 0 (selection failed) and bits 2 and 3 are not ‘01’, the SP attempted 
device selection and failed. The failure preventing selection is reported in 

i sense information as Environmental Data Present (Byte 2, bit 3) in the 
next initial selection to the failing device. 


1 Set to zero. 


2-3 Reservation Status. 
00 = Device is not reserved. 
01 = Device is reserved to another channel or path group. 
10 = Device is reserved to this channel or path group. 


4-5 Allegiance Reset for the Addressed Device. 
00 = No Allegiance was reset for the device. 
01 = Implicit Allegiance was reset for the device. 
10 = Contingent Allegiance was reset for the device.. 


6 Contingent Allegiance was reset on another device. 


7 Implicit Allegiance was reset on another device. 
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Reset Allegiance 


3-46 


Data Address — Defines main storage location of the first device status byte. 
Flags — Used at the programmer’s discretion. 

Count — 32. a 
Initial Status — Normally 0. 


Chaining Requirements — This command is not a valid command in the domain of a 
Locate Record command. Reset Allegiance must be the first command in the channel 
program. If any command precedes it, Reset Allegiance is rejected. If the device is 
reserved to another channel or path group, the Reset Allegiance command only returns 
the 32 bytes of sense data and any command chained to Reset Allegiance is rejected. A 
command rejection results in Unit Check ending status and the sense information 
reports Command Reject with Format 0, Message 2 (Invalid Sequence). 


If the device is either not reserved or is reserved to this channel or path group, the 
following occurs: 


¢ Any CCW chain in progress on this device for this channel or path group is 
terminated and any status for the CCW chain (including sense data) is reset. 
Multitagged or untagged status for this device is not reset, however. 


e Any chain in progress on this device for a different channel or path group is 
terminated with Unit Check ending status, and any pending sense data changes. 
Sense information contains Equipment Check with Format 3, Message F 
(Allegiance Terminated). 


¢ The device will be selected if possible, using unconditional selection sequences if 
necessary. If selection is successful, normal chaining requirements apply to any 
CCW that is chained to this one. If selection is not successful, any CCW that is 
chained to this one is rejected with Unit Check ending status. Sense information 
reports Command Reject with Format 0, Message 2 (Invalid Sequence). 
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Read Data 


« 3.26 Read Data 
Command Code 06 (hex) 


Command Code 86 (hex) multitrack = 


This command transfers the Data field of a record from the drive to main storage. The 
data read falls into the following categories: 


¢ Data field of a record read by a Search ID or Search Key immediately preceding 
the Read Data command. 


¢ Data field of a record read by Read Count or Space Count immediately preceding 
the Read Data command. 


¢ Data field of the record associated with the next Count field. The exception is 
Record 0. 


ECC bytes following each Data field are used to validate the field. Channel End and 

Device End are posted when the ECC check for the Data field completes successfully. If 

an uncorrectable Data Check or Command Overrun condition is detected, Channel End, 

Device End, and Unit Check are presented to the channel. If the error is correctable, the 

sense information is set so that error recovery procedures can proceed. Command retry is 
pe, initiated by the SP for all error conditions considered correctable by retry. 


Note: When this command processes a +ecord with a data length of 0 (End of File), \A¢uatGh 
a Unit Exception status is set in the CSW (bit 39). 


In the domain of a Locate Record command, if the end of the track is detected before a 
Count field, the Read operation continues depending on the state of the multitrack bit 
(bit 0) in the CSW. 


¢ When the multitrack bit is 0, the SP is oriented to the Count field of the first data 
record on the same track. The SP sends the Data field of the record to the 
channel. Ifthe track does not have a data record, the Read Data command is 
terminated with Unit Check ending status and No Record Found in the 
subsequent sense information. 


¢ When the multitrack bit is 1, the SP advances to the next track and sends the 
Data field of the first record to the channel (refer to Locate Record command). 
Again, if the track does not have a data record, the Read Data command is 
terminated with Unit Check ending status and No Record Found in the 
subsequent sense information. 


For multitrack read commands that are not in a Locate Record domain, the SP selects 
the next sequential head (on the same cylinder as the currently read track) when Index is 
detected, indicating the end of that track. Sequential head selection continues until the 
read command is satisfied or until the End of Cylinder (EOC) is reached. When EOC is 
detected, Channel End, Device End, and Unit Check are presented to the channel. The 
next sense information returned will show EOC as set in Sense Byte 1, bit 2. EOC is 

Er determined after the last track (14) on a logical cylinder is read. An attempted head 

ok switch from Track 14 will generate the EOC indication. 


c 
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Read Data 


Data Address — Defines main storage location where first Data field byte is to be 
transferred. 


Flags — Used at the programmer’s discretion. 

Count — Indicates number of bytes to be received. ~ 
Initial Status — Normally 0. 

Chaining Requirements — A Seek, Seek Cylinder, Locate Record, Read IPL, or 
Recalibrate command must precede Read Data. A Read (code 16) or Read Data (code 06) 
can be the only operation specified in the domain of a Locate Record command. 

Any other conditions for the Read Data command result in Unit Check ending status 


with sense data containing Command Reject with Format 0, Message 2 (Invalid 
Sequence). 
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Read Key and Data 


€ 3.27 Read Key and Data 
Command Code OE (hex) 
Command Code 8E (hex) multitrack 


This command transfers the Key and Data fields of a record from the drive to main 
storage. The key and data read falls into the following categories. 


¢ Key and Data fields of a record read by Search ID immediately preceding the Read 
Key and Data command. 


¢ Key and Data fields of a record read by Read Count or Space Count immediately 
preceding the Read Key and Data command. 


¢ Key and Data fields of the record associated with the next Count field. The 
exception is Record 0. ECC bytes following each Key and Data fields are used to 
validate the fields. Channel End and Device End are posted when the ECC check 
for the two fields completes successfully. A Data Check or Command Overrun 
condition, if detected, initiates an SP recovery attempt by command retry. If 
command retry is not used or is unsuccessful when a Command Overrun or Data 
Check condition occurs, Channel End, Device End, and Unit check are posted. 


Ve Note: When this command processes a record with a data length of 0 (End of File), 
. a Unit Exception status is set in the CSW (bit 39). In this case, the data 
transfer halts once the Key field is processed. 


& In the domain of a Locate Record command, if the end of the track is detected before a 


Count field, the Read operation continues depending on the state of the multitrack bit 
(bit 0) in the CSW. 


¢ When the multitrack bit is 0, the SP is oriented to the Count field of the first data 
record on the same track. The SP sends the Key and Data fields of the record to 
the channel. If the track does not have a data record, the Read Key and Data 
command is terminated with Unit Check ending status and No Record Found in 
the subsequent sense information. 


¢ When the multitrack bit is 1, the SP advances to the next track and sends the Key 
and Data fields of the first record to the channel (refer to Locate Record command). 
Again, if the track does not have a data record, the Read Key and Data command 
is terminated with Unit Check ending status and No Record Found in the 
subsequent sense information. 


For multitrack read commands that are not in the Locate Record domain, the SP selects 
the next sequential head (on the same cylinder as the current track) when Index is 
detected, indicating the end of that track. Sequential head selection continues until the 
read command is satisfied or until End of Cylinder (EOC) is reached. When EOC is 
detected, Channel End, Device End, and Unit Check are presented to the channel. The 
next sense information returned will show EOC as set in Sense Byte 1, bit 2. EOC is 
determined after the last track (14) on a logical cylinder is read. An attempted head 
Ae. switch from Track 14 will generate the EOC indication. 
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Read Key and Data 


Data Address — Defines main storage location where the first byte of Key field data is 
to be transferred. a 


, Flags — Used at the programmer’s discretion. 
Count — Indicates the number of Key and Data field bytes to be received. 
Initial Status — Normally 0. 


Note: Akey length of zero causes the command to operate as a Read Data 
command. 


Chaining Requirements — A Seek, Seek Cylinder, Locate Record, Read IPL, or 
Recalibrate command must precede Read Data. A Read (code 16) or Read Data (code 06) 
can be the only operation specified in the domain of a Locate Record command. 


Any other conditions for the Read Key and Data command result in Unit Check ending 
status with sense data containing Command Reject with Format 0, Message 2 (Invalid 
Sequence). 
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Read Count, Key, and Data 


3.28 Read Count, Key, and Data 
Command Code 1E (hex) 


Command Code 9E (hex) multitrack 


This command transfers the next record encountered on the track (excluding Record 
Zero) from the drive to main storage. 


ECC bytes following each field are used to validate the field. Channel End and Device 
End are posted when the ECC check for all fields completes successfully. A Data Check 
or Command Overrun condition, if detected, initiates an SP recovery attempt by 
command retry. If command retry is not used or is unsuccessful when a Command 
Overrun or Data Check condition occurs, Channel End, Device-End, and Unit Check are 
posted. 


Note: When this command processes a record with a data length of 0 (End of File), 
a Unit Exception status is set in the CSW (bit 39). In this case, the data 
transfer halts once the Count field (if key length = 0) or Key field is processed. 


In the domain of a Locate Record command, if the end of the track is detected before a 
Count field, the Read operation continues depending on the state of the multitrack bit 
(bit 0) in the CSW. 


¢ When the multitrack bit is 0, the SP is oriented to the Count field of the first data 
record on the same track. The SP sends the Count, Key, and Data fields of the 
record to the channel. If the track does not have a data record, the Read Count, 
Key, and Data command is terminated with Unit Check ending status and No 
Record Found in the subsequent sense information. 


¢ When the multitrack bit is 1, the SP advances to the next track and sends the 
Count, Key, and Data fields of the first record to the channel (refer to Locate 
Record command). If the track does not have a data record, the Read Count, Key, 
and Data command is terminated with Unit Check ending status and No Record 
Found in the subsequent sense information. 


For multitrack commands that are not in the domain of a Locate Record, the SP selects 
the next sequential head (on the same cylinder as the current track) when Index is 
detected, indicating the end of that track. Sequential head selection continues until the 
read command is satisfied or until End of Cylinder (EOC) is reached. When EOC is 
detected, Channel End, Device End, and Unit Check are presented to the channel. The 
next sense information returned will show EOC as set in Sense Byte 1, bit 2. EOC is 
determined after the last track (14) on a logical cylinder is read. An attempted head 
switch from Track 14 will generate the EOC indication. 


Data Address — Defines main storage location where first byte of Count data is to be 
transferred. 


Flags — Used at the programmer’s discretion. 


Count — Indicates the number of Count, Key, and Data field bytes to be received. 
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Read Count, Key, and Data 


Initial Status — Normally 0. 


Chaining Requirements — A Seek, Seek Cylinder, Locate Record, Read IPL, or Ja 
Recalibrate command must precede Read Count, Key, and Data. A Read (code 16) or 
Read Data (code 06) can be the only operation specified in the domain of a Locate Record 
command. = 


Any other conditions for the Read Count, Key, and Data command result in Unit Check 
ending status with sense data containing Command Reject with Format 0, Message 2 
(Invalid Sequence). 
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Read Multiple Count, Key, and Data 


© 3.29 Read Multiple Count, Key, and Data 


Command Code 5E (hex) 


This command is similar to executing Read Count, Key, and Data commands over and 
over until the next Index is detected. In short, the command transfers the next record 
and all remaining records encountered on the track (excluding Record Zero) from the 
drive to main storage. 


ECC bytes following each field are used to validate the field. Channel End and Device 
End are posted when the ECC check for the last Data field completes successfully. Unit 
Exception is not issued for zero-length Data fields. 


Data Address — Defines main storage location where the first byte of Count data is to 
be transferred. 


Flags — Used at the programmer’s discretion. 


Count — In order to read the entire track, the count must exceed 8 (Count field) + 
47,476 (maximum Record 1 Key and Data fields). 


Initial Status — Normally 0. 


Chaining Requirements — This command must be preceded by a Seek, Seek Cylinder, 
Locate Record, Recalibrate, or Read IPL command. Also, the Read Multiple Count, Key, 

Cc and Data command must not be within the domain of a Locate Record command. If 
these requirements are not met, the command is rejected with Unit Check ending status 
and the sense information reports Command Reject with Format 0, Message 2 (Invalid 
Sequence). 
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Read Record Zero (RO) 


3.30 Read Record Zero (RO) 2 
Command Code 16 (hex) 


Command Code 96 (hex) multitrack 


This command transfers Count, Key, and Data fields for Record 0 (RO) from the drive to 
main storage. 


ECC bytes following each field are used to validate the field. Channel End and Device 

End are posted when the ECC check for all fields completes successfully. A Data Check 

or Command Overrun condition, if detected, initiates an SP recovery attempt by 

command retry. If command retry is not used or is unsuccessful when a Command 

Overrun or Data Check condition occurs, Channel End, Device End, and Unit Check are : . 
posted. 


Note: When this command processes a record with a data length of 0 (End of File), 
a Unit Exception status ts set in the CSW (bit 39). In this case, the data 
transfer halts once the Count field (if key length = 0) or Key field is 
processed. 


In the domain of a Locate Record command, the SP is oriented to Home Address when it : 
receives this command. Data transfer begins with the following Record 0 Count field. If ( 
the SP is not oriented to Home Address when starting a multitrack Read Record 0, the : 
command always advances to the next track before sending Record 0. 


For multitrack commands that are not in a Locate Record domain, the SP selects the next Jd 
sequential head (on the same cylinder as the current track) when Index is detected, 

indicating the end of that track. Sequential head selection continues until the read 

command is satisfied or until End of Cylinder (EOC) is reached. When EOC is detected, 

Channel End, Device End, and Unit Check are presented to the channel. The next sense 

information returned will show EOC as set in Sense Byte 1, bit 2. EOC is determined 

after the last track (14) on a logical cylinder is read. An attempted head switch from 

Track 14 will generate the EOC indication. 


Data Address — Defines main storage location where first byte of RO Count data is to 
be transferred. 


Flags — Used at the programmer’s discretion. 
Count — Indicates number of Count, Key, and Data field bytes to be received. 
Initial Status — Normally 0. 


Chaining Requirements — A Seek, Seek Cylinder, Locate Record, Read IPL, or 
Recalibrate command must precede Read Record 0. A Read (code 16) or Read Data (code 
06) and Index or Home Address orientation (Byte 0, bits 0 and 1 are “11” or “01”) can be 
the only operation specified in the domain of a Locate Record command. Any other 
conditions for the Read Record 0 command result in Unit Check ending status with sense 
data containing Command Reject with Format 0, Message 2 (Invalid Sequence). 
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Read Count 


( 3.31 Read Count 
Command Code 12 (hex) 


Command Code 92 (hex) multitrack 


This command reads the eight bytes containing cylinder (2 bytes), head (2 bytes), record 
number (1 byte), key length (1 byte), and data length (2 bytes) (CC, HH, R, KL, DL, DL) 
from the next Count field encountered on the track (excluding Record 0). The drive 
transfers this information to main storage. 


ECC bytes following each Count field are used to validate the field. Channel End and 
Device End are posted when the ECC check for the Count field completes successfully. A 
Data Check or Command Overrun condition, if detected, initiates an SP recovery attempt 
by command retry. If command retry is not used or is unsuccessful when a Command 
Overrun or Data Check condition occurs, Channel End, Device End, and Unit Check are 
posted. 


In the domain of a Locate Record comman4d, if the end of the track is detected before a 
Count field, the Read operation continues depending on the state of the multitrack bit 
(bit 0) in the CSW. 


¢ When the multitrack bit is 0, the SP is oriented to the Count field of the first data 
record on the same track. The SP sends the Count field of the record to the 
channel. If the track does not have a data record, the Read Count command is 
terminated with Unit Check ending status and No Record Found in the 
<= subsequent sense information. 


¢ When the multitrack bit is 1, the SP advances to the next track and sends the 
Count field of the first record to the channel (refer to Locate Record command). 
Again, if the track does not have a data record, the Read Count command is 
terminated with Unit Check ending status and No Record Found in the 
subsequent sense information. 


For multitrack commands that are not in a Locate Record domain, the SP selects the next 
sequential head (on the same cylinder as the current track) when Index is detected, 
indicating the end of that track. Sequential head selection continues until the read 
command is satisfied or until End of Cylinder (EOC) is reached. When EOC is detected, 
Channel End, Device End, and Unit Check are presented to the channel. The next sense 
information returned will show EOC as set in Sense Byte 1, bit 2. EOC is determined 
after the last track (14) on a logical cylinder is read. An attempted head switch from 
Track 14 will generate the EOC indication. 


Data Address — Defines main storage location where first byte of Count data is to be 
transferred. 


Flags — Used at the programmer’s discretion. 


Count — 8. 


Initial Status — Normally 0. 
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mead Count 


Chaining Requirements — The Read Count command has the following chaining 
requirements and restrictions. 


¢ A Seek, Seek Cylinder, Locate Record, Read IPL, or Recalibrate command must 
precede Read Count. 


¢ A Read (code 16) or Read Data (code 06) can be the only operation specified in the 
domain of a Locate Record command. 


e Read Count must be suffixed to a Locate Record domain that specifies a Write 
Data (code 01) operation and Read Count CCW suffix (auxiliary byte, bit 7 is set 
to 1). 


Any other conditions for the Read Count command result in Unit Check ending status 
with sense data containing Command Reject with Format 0, Message 2 (Invalid 
Sequence). 
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Read Home Address 


C 3.32 Read Home Address 


a 
a 
* 


MOB. 
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Command Code 9A (hex) multitrack 


Command Code 1A (hex) 


This command transfers the flag, cylinder (2 bytes), and head (2 bytes) information 
(FCCHH) in the Home Address field to main storage. 


ECC bytes following each Home Address field are used to validate the field. Channel End 
and Device End are posted when the ECC check for the Home Address field completes 
successfully. A Data Check or Command Overrun condition, if detected, initiates an SP 
recovery attempt by command retry. If command retry is not used or is unsuccessful 
when a Command Overrun or Data Check condition occurs, Channel End, Device End, 
and Unit Check are posted. 


When in the domain of a Locate Record, the SP is oriented to Index when the Read Home 
Address command starts. The 5-byte Home Address transfers to the channel. 


For multitrack commands that are not in the domain of a Locate Record, the SF selects 
the next sequential head (on the same cylinder as the current track) when Index is 
detected, indicating the end of that track. Sequential head selection continues until the 
read command is satisfied or until End of Cylinder (EOC) is reached. When EOC is 
detected, Channel End, Device End, and Unit Check are presented to the channel. The 
next sense information returned shows EOC as set in Sense Byte 1, bit 2. EOC is 
determined after the last track (14) on a logical cylinder is read. An attempted head 
switch from this Track 14 will generate the EOC indication. 


Data Address — Defines main storage location where Home Address is to be stored. 
Flags — Used at the programmer’s discretion. 

Count — 5. 

Initial Status — Normally 0. 

Chaining Requirements — A Seek, Seek Cylinder, Locate Record, Read IPL, or 
Recalibrate command must precede Read Home Address. A Read (code 16) or Read Data 
(code 06) and Index orientation (Byte 0, bits 0 and 1 are ‘11’) can be the only operation 
specified in the domain of a Locate Record command. 

Any other conditions for the Read Home Address command result in Unit Check ending 


status with sense data containing Command Reject with Format 0, Message 2 (Invalid 
Sequence). 
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Read IPL 


3.33 Read IPL 


Command Code 02 (hex) 


This command performs an Initial Program Load (IPL) by instructing the SP toreturn 
the selected drive to Cylinder 0, Head 0, and search for Index. Upon detecting Index, the 
Record 1 Data field is transferred. This command is normally initiated by setting the 
device address in the LOAD ADDRESS switches on the CPU Operator Panel and 
pressing the IPL (LOAD) button. 


Note: When this command processes a record with a data length of 0 (End of File), 
a Unit Exception status is set in the CSW (bit 39). 


ECC bytes following each Data field are used to validate the field. Channe] End and 
Device End are posted when the ECC check for the Record 1 Data field completes 
successfully. A Data Check or Command Overrun condition, if detected, initiates an SP 
recovery attempt by command retry. If command retry is not used or is unsuccessful 
when a Command Overrun or Data Check condition occurs, Channel End, Device End, 
and Unit Check are posted. 


Data Address — Defines main storage location where first byte of data is to be 
transferred. 


Flags — Used at the programmer’s discretion. . C 
Count — Indicates number of bytes to be received. 

Initial Status — Normally 0. a 
Chaining Requirement — The Read JPL command is not valid within the domain of a 

Locate Record command. If it is inadvertently used with Locate Record, the command is 


rejected with Unit Check ending status. The sense information reports Command Reject 
with Format 0, Message 2 (Invalid Sequence). 


If the command was preceded in the same channel program by a Define Extent or Set File 
Mask command, the command is terminated with Unit Check ending status. The sense 
data reports Command Reject with Format 0, Message 2. 
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Read Sector 


« 3.34 Read Sector 


Command Code 22 (hex) ; 
This command transfers one byte of data from the SP to main storage. The byte 
transferred normally contains the sector number required to access the Count field of the 
last record processed. Execution of this command resets orientation information in the 
SP. Channel End and Device End are posted when the sector number transfer is 
complete. 


Data Address — Defines main storage location where the sector number is to be 
transferred. 


Flags — Used at the programmer’s discretion. 

Count — 1. 

Initial Status — Normally 0. 

Special Requirement — This command is not valid within the domain of a Locate 
Record command. If itis inadvertently used with Locate Record, the command is 


rejected with Unit Check ending status. The sense information reports Command Reject 
a with Format 0, Message 2 (Invalid Sequence). 
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Read Track 


3.35 Read Track 


Command Code DE (hex) 


3-60 


The Read Track command transfers multiple records from the drive to the channel. 
Primarily used for dump/restore utility programs, the command sends all records from a 
device track without first having to determine the number of records on the track and 
their formats. After reading the last record on the track, a pseudo Count area of 8 bytes 
with a value of FF transfers to the channel. If channel data transfer truncates because of 
an exhausted byte count or an exception condition, no pseudo Count transfers to indicate 
the end of the track in the host processor storage. 


The SP presents Channel End and Device End status when data transfer completes. 
When the command completes, the SP is oriented to the Data area of the last record on 
the track. 


Data Address — Defines the main storage location for the first Count area. 
Flags — Used at the programmer’s discretion. 


Count — Value should be at least as large as that defined for the maximum record size 
that can be written on the track, plus the length of the Record 0 Count and Data areas, 
plus 8 bytes for the pseudo Count area. 


Initial Status — Normally 0. 


Chaining Requirements — Unit Check ending status (sense information reporting 
Command Reject with Format 0, Message 2) occurs if the Read Track command is: 


¢ Not in a Locate Record domain that specifies a Read Track (code OC) operation or, 


¢ Not immediately preceded by a Locate Record command or another Read Track 
command. 


The first Read Track command in a Locate Record domain is oriented to the first Count 
area (including Record 0) that follows the orientation established by the Locate Record 
command. The SP sends each Count, Key, and Data area on the track until the end of 
the track is reached. Ifthe orientation is to Home Address and there is no Record 0, the 
command is terminated with Unit Check ending status (No Record Found). If 
end-of-track occurs before a Count area, only a pseudo Count area of 8 bytes of FF 
transfers and the SP does not report this action as an exception condition. 


Within the domain of a Locate Record command, the following Read Track commands 
cause the SP to: 


1. Advance to the next track 
2. Be oriented to Home Address 


3. Send each Count, Key, and Data area (Record 0 included) on the track until end of 
track occurs. 
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Read Track 


If the next track does not have a Home Address, the command is terminated with Unit 
'S Check ending status. The sense information reports a Data Check for the specific device. 

If there is no Record 0 on the next track, the command is terminated with Unit Check 

ending status (No Record Found). ; 

If the length of the Data area is zero. the SP does not transfer the Data area and does not 

report an exception status. The Read operation continues with the next Count area, if 

any, on the track. 


The Read Track command will not read a track that is marked defective. If the 
command accesses a defective track, the data is read from the assigned alternate track. 
If an alternate track has not been assigned, or an invalid alternate track has been 
assigned, the command is rejected with Unit Check ending status. The sense data 
reports Command Reject with Format 0, Message B (Improper Alternate Track Pointer). 


If end of track occurs in a record, the command is terminated with Unit Check ending 
status indicating Invalid Track Format. 
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3.36 Write Data 


Command Code 05 (hex) 


3-62 


- 


This command performs normal record updating on a formatted track. Execution of this 
command causes specified data in main storage to be written in the Data field of the 
selected record. The number of bytes transferred is specified in the CCW count. ECC 
bytes are written at the end of the Data field; Channel End and Device End are posted 
after the ECC bytes have been written for the Data field. 


Note: When this command processes a record with a data length of 0 (End of File), 
a Unit Exception status ts set in the CSW (bit 39). 


Data Address — Defines main storage location of data used to update record. 
Flags — Used at the programmer’s discretion. 


Count — Indicates number of Data field bytes to be transferred. If CCW count is less 
than the formatted record data length, the SP pads with zeros for the remainder of the 
Data field. If CCW count is greater than the formatted record data length, the SP writes 
only the number of bytes indicated in the Count field for the record. If the CCW count 
does not match the data length, an incorrect length condition will be returned unless Bit 
34 is set in the CCW flag. ( | 


Initial Status — Normally 0. 


Chaining Requirements — Write Data is a valid command in the domain of a Locate J 
Record that specifies one of the following: 


¢ A Write Track (code OB) operation 


¢ A Write Data (code 01) operation that requires only one Write operation (either a 
Count of 1 or, with Read Count CCW suffix, a Count of 2). 


If either of these conditions is not met when in the domain of Locate Record, the 
command is rejected with Unit Check ending status. Subsequent sense information 
reports Command Reject with Format 0, Message 2 (Invalid Sequence). 


When outside the domain of a Locate Record, this command must be chained from the 
Search ID Equal or Search Key Equal (the Search command must compare equal on all 
bytes of the searched field). When chaining requirements are not met, Device End, 
Channel End, and Unit Check are presented in the ending status. 


Unit Check ending status (sense information reporting Command Reject with Format 0, 
Message 2) also occurs if one of the following conditions is encountered: 
¢ The file mask does not permit Update Write operations (bits 0 and 1 are ‘01’) 


¢ The currently accessed track is in the device-support address space and the 
command is outside the domain of Locate Record. 
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Write Key and Data 


© 3.37 Write Key and Data 


Command Code OD (hex) 


The command performs record updating on a formatted track. Execution of this 
command causes specified data in main storage to be written in the Key and Data fields 
of the selected record. The number of bytes transferred is specified in the CCW count. 
ECC bytes are written et the end of the Key and the Data fields; Channel End and 
Device End are posted after the ECC bytes have been written for the Data field. 


Note: When this command processes a record with a data length of 0 (End of File), 
a Unit Exception status is set in the CSW (bit 39). In this case, the data 
transfer halts once the Key field is processed. 


Data Address — Defines main storage location of data used to update record. 
Flags — Used at the programmer’s discretion. 


Count — Indicates number of Key and Data field bytes to be transferred. If CCW count 
is less than the formatted record key length and data length, the SP pads with zeros for 
the remainder of each field. If CCW count is greater than the formatted record key length 
er and data length, the SP writes only the number of bytes indicated for the two fields in 
: the Count field of the record. If the CCW count does not match the data length, an 
incorrect length condition will be returned unless Bit 34 is set in the CCW flag. 


‘S Initial Status — Normally 0. 


Chaining Requirements — Write Key and Data is a valid command in the domain of a 
Locate Record that specifies Write Data (code 01) and requires only one Write operation 
(either a Count of 1 or, with Read Count CCW suffix, a Count of 2). If this condition is 
not met, the command is rejected with Unit Check ending status. Subsequent sense 
information reports Command Reject with Format 0, Message 2 (Invalid Sequence). 


When outside the domain of a Locate Record, this command must be chained from the 
Search ID Equal (the Search ID Equal command must compare equal on all bytes of the 
searched field). When chaining requirements are not met, Device End, Channel End, 
and Unit Check are presented in the ending status. 


Unit Check ending status (sense information reporting Command Reject with Format 0, 
Message 2) also occurs if one of the following conditions is encountered: 
¢ The file mask does not permit Update Write operations (bits 0 and 1 are ‘01’) 


¢ The currently accessed track is in the device-support address space and the 
command is outside the domain of Locate Record. 


Note: If the key length is zero, this command is, in effect, a Write Data command. 
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3.38 Write Count, Key, and Data 
Command Code 1D (hex) 


This command allows the Count, Key, and Data fields of a record in main storage to be 
written on the specified track of the selected drive. The Count field is made up of the 
first eight bytes from main storage; record ID (CCHHR: five bytes) + key length (one 
byte) + data length (two bytes). The flag byte is generated by the SP; the remaining data 
is written in the Key and Data fields as specified by the key length and data length bytes 
in the Count field. ECC bytes are written at the end of the Count, Key, and Data fields; 
Channel End and Device End are posted after the ECC bytes are written for the Data 
field. 


Data Address — Defines main storage location of the Count, Key, and Data field bytes 
to be transferred. 


Flags — Used at the programmer’s discretion. 


Count — Indicates number of Count, Key, and Data field bytes (8 + KL + DL) to be 
transferred. If CCW count is less than 8 + KL + DL, the SP writes zeros in the remainder 
of the record. 


Initial Status — Normally 0. 


Chaining Requirements — Unit Check ending status (sense information reporting 
Command Reject with Format 0, Message 2) occurs if one of the following conditions is en- 
countered. 


¢ The Write Count, Key, and Data command is not in a Locate Record domain and is € 
not preceded by one of the following: . 


— A Search Id Equal or Search Key Equal command that compares equal on J 
all bytes of the ID or Key field (see Note below) 


— A Write Record 0 command or a Write Count, Key, and Data command that 
is not in the domain of a Locate Record. 


— The Write Count, Key, and Data command is outside the Locate Record 
domain and the currently accessed track is in the device-support address 
space. 


e The file mask inhibits Format Write operations (bits 0 and 1 are ‘10’). 
e This command follows a Write Record 0 command that assigns an alternate track. 


¢ The Write Count, Key, and Data command is in the domain of a Locate Record that 
does not specify either a Format Write (code 03) or a Write Track (code OB) 
operation. 


Note: A Read Data and/or Read Key and Data command may be chained between 
the Search ID Equal command and the Write Count, Key, and Data 
commands. A Write Data or a Write Key and Data command may be inserted 
between Search ID and the Write Count, Key, and Data, or a Write Data 
command may be inserted between a Search Key and the Write Count, Key, 
and Data. 
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Write Record Zero (RO) 


oe 


© 3.39 Write Record Zero (RO) 


Command Code 15 (hex) : 
This command transfers the Count, Key, and Data fields for Record 0 from main storage 
to the track. The Count field is made up of the first eight bytes from main storage. The 
flag is generated by the SP; the remaining data is written in the Key and Data fields 
specified by the key length and data length bytes in the Count field. ECC bytes are 
written following each field. Channel End and Device End are posted after the ECC 
bytes are written for the Data field. 


IBM-compatible data management systems require a zero key length and an eight-byte 
Data field in Record 0. 


Data Address — Defines main storage location of Record 0 Count, Key, and Data field 
bytes to be transferred. 


Flags — Used at the programmer’s discretion. 
Count — Indicates number of Count, Key, and Data field bytes (8 + key length + data 
length) to be transferred. If CCW count is less than 8 + key length + data length, the SP 


(oe writes zeros in the remainder of the record. 


Initial Status — Normally 0. 


c Chaining Requirements — Unit Check ending status (sense information reporting 
Command Reject with Format 0, Message 2) occurs if one of the following conditions is 
encountered. 


¢ The Write Record 0 command is not in a Locate Record domain and is not preceded 
by one of the following: 


— A Search Home Address command that compares equal on all four Home Ad- 
dress bytes 


— A Write Home Address command that is not in the domain of a Locate 
Record. 


— The Write Home Address command is outside the Locate Record domain and 
the currently accessed track is in the device-support address space. 


¢ The file mask inhibits the Record 0 Write operation (bits 0 and 1 are not ‘11’). 


¢ This command is in the domain of a Locate Record that does not specify a Format 
Write (code 03) operation with Home Address or Index orientation (Byte 0, bits 0 
and 1 are ‘01’ or ‘11’). 


Note: Record 0 is normally written on the disk media by the manufacturer. The 
use of this command should be limited to identifying defective tracks and 
assigning alternate tracks. Utility programs are available to perform these 
functions. The RO CCHH bytes of the alternate track contain the address of 

es the defective track and the RO CCHH bytes of the defective track contain the 

Se address of the alternate track. 
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3.40 Write Home Address 


Command Code 19 (hex) 


This command transfers the Home Address from main storage to the track. The SP 
orients on Index and writes Gap 1, the Home Address, and ECC bytes. Channel End and 
Device End are posted after the ECC bytes are written for the Home Address field. 


Data Address — Defines main storage location of the Home Address bytes; the format 
of these bytes is FCCHH (only the last two bits of F, the Home Address flag, are used). 


Flags — Used at the programmer’s discretion. 


Count — Must be 5. If less than 5, Command Reject-ig-presented. If greater than 5, only 
five bytes are transferred. 


Initial Status — Normally 0. 


Chaining Requirements — Unit Check ending status (sense information reporting 
Command Reject with Format 0, Message 2) occurs if one of the following conditions is 
encountered. 


¢ The Write Home Address command is not in a Locate Record domain and is not 
preceded by a Search Home Address command that compares equal on all four 
Home Address bytes of the track address field 


¢ The Write Home Address command is outside the Locate Record domain and the 
currently accessed track is in the device-support address space. 


¢ The file mask inhibits the Home Address Write operation (bits 0 and 1 are not ‘11’). 


¢ This command is in the domain of a Locate Record that does not specify a Format 
Write (code 03) operation with Home Address orientation (Byte 0, bits 0 and 1 are 
01’). 


Special Requirements — Write Home Address establishes track identity (prerequisite 
for data operations on the track) and writes zeros on the balance of the track if this is the 
last command in a CCW chain. 


The SP verifies Home Address data from the channel as follows: 


¢ Bits 0 through 5 of the flag byte must be 0. 


¢ Flag byte, bits 6 and 7, must be ‘01’ or ‘11’ if the addressed track is in the alternate 
track address space. Bits 6 and 7 must be ‘00’ or ‘10’ if the track is not an 
alternate track. 


¢ The track address must equal the address of the currently accessed track. 
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«¢ 3.41 Erase 


Command Code 11 (hex) 


This command writes zeros on the remainder of the specified track. The erased record 
and all records that follow on the track are not recoverable. Channel End and Device 
End are presented after ECC bytes have been read or written at the end of the Data field 
for the previous record. 


Data Address — Defines main storage location of the Count, Key, and Data field bytes. 
Flags — Used at the programmer’s discretion. 


Count — Indicates number of bytes to be transferned for the Count, Key, and Data 
fields. 


Note: Even though the Count, Key, and Data field bytes are transferred to the SP, 
they are not written on the track. 


Initial Status — Normally 0. 


sap Chaining Requirements — Unit Check ending status (sense information reporting 
( Command Reject with Format 0, Message 2) occurs if one of the following conditions is 
encountered. 


> Er 


= ¢ The Erase command is not in a Locate Record domain and is not preceded by one 
of the following: 


— A Search ID Equal or Search Key Equal command that compares equal on 
all bytes of the ID or Key field, or 


— A Write Record 0 or Write Count, Key, and Data command that is not in the 
domain of a Locate Record. 


¢ The Erase command is outside the Locate Record domain and the currently 
accessed track is in the device-support address space. 


¢ The file mask inhibits Format Write operations (bits 0 and 1 are ‘01’ or ‘10’). 


¢ This command is in the domain of a Locate Record that does not specify a Write 
Track (code 0B) operation. 


Read Data and Read Key and Data commands may be chained between Search ID Equal 
and Erase commands. Read Data may be chained between Search Key Equal and Erase. 
Write Data or Write Key and Data may be chained between Search ID (Equal, High, or 
Equal High) and Erase. Additionally, Write Data may be chained between Search Key 
(Equal, High, or Equal High) and Erase. 
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3.42 Write Count, Key, and Data Next Track 
Command Code 9D (hex) 


The Write Count, Key, and Data Next Track command formats the first user Data record 
on the next track. The first 8 bytes of the record are the Count area; the remaining bytes 
are written into the Key and Data areas. If the channel sends less than an 8-byte Count 
area, the remainder of the Count area is filled with binary zeros. The Write operation 
continues and zeros are used to fill any fields that are not transferred. 


The storage path is oriented to a Data area when this command is started. It then erases 
the remaining portion of the current track, advances to the next track, and formats a 
user Data record following Record 0 on the next track. 


If there is no Record 0 on the next track, the »peration is terminated with Unit Check 
ending status (No Record Found). 


After the Count area transfers, the SP receives the Key and Data areas from the 
channel. The lengths of these areas are defined in the Count area. If the key length (KL) 
is zero, the record formats without a Key area. If the data length (DL) is zero, the record 
formats as an end-of-file record. If the channel provides less bytes than the sum of KL + 
DL, the SP fills the remaining bytes of the Key and Data areas with binary zeros. 


Channel End and Device End status are presented after the device completes the Write 
operation. When the command completes, the SP is oriented to the Data area of the 
record that was just written. 


Data Address — Defines the main storage location of the Count (8 bytes), Key, and 
Data bytes. 


Flags — Used at the programmer’s discretion. 
Count — The number of bytes to write. 


Chaining Requirements — Write Count, Key, and Data Next Track is valid only in the 
domain of a Locate Record command which specifies a Format Write (code 03) operation. 
If this command is not followed by a Write Count, Key, and Data command, the 
remaining portion of the track is erased. This command can only be chained from a 
Write Count, Key, and Data command or another Write Count, Key, and Data Next Track 
command. 


If there is not enough space on the track to write the complete record, the command is 
terminated with Unit Check status (Invalid Track Format). The track may contain a 
partial record, and the residual byte count in the CSW may not indicate the amount by 
which the length of the record exceeded the available space on the track. 
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q 3.43 Write Update Data 


Command Code 85 (hex) 


The Write Update Data command updates the Data field of an existing record. The SP 
writes the existing record with the amount of data specified in the transfer length factor 
parameter of the Locate Record command (or the block size parameter of the Define 
Extent command if the transfer length factor was not specified). If the channel transfers 
less than the specified number of bytes, the remaining area of the Data field is filled with 
zeros; if too many bytes are sent, only the specified number of bytes are written in the 
Data field. 


If the SP is oriented to a Count field when the command starts (as a result of the 
preceding Locate Record command), it writes the following Data field. If the SP is not 
oriented to a Count field at the start of the command (the preceding command was a 
Write Update Data command), it is oriented to the next Count field. It then writes the 
first user record on that track (not Record 0). 


If end-of-track occurs, and the next track is in the extent defined by the previous Define 
Extent command, the SP advances to the next track. 


Channel End and Device End are presented when the device completes the Write 
a operation. When the command completes, the SP is oriented to the Data field of the 
is record just updated. 


Data Address — Defines the main storage location of the data. 
Flags — Used at the discretion of the programmer. 


Count — Indicates the number of Data field bytes to write. If CCW count is less than 
the record data length, the SP pads with zeros for the remainder of the Data field. If 
CCW count is greater than the record data length, the SP writes only the number of 
bytes indicated in the Count field for the record. 


Initial Status — Normally 0. 


Chaining Requirements — Write Update Data is a valid command only in the domain 
of a Locate Record that specifies a Write Data (code 01) operation. If this condition is not 
met, the command is rejected with Unit Check ending status. Subsequent sense 
information reports Command Reject with Format 0, Message 2 (Invalid Sequence). 


If the transfer length factor (Locate Record) or block size (Define Extent) value is not 
equal to the Count field data length value of the record, the record is not updated. The 
operation ends with Unit Check status (Invalid Track Format). In addition, if 
end-of-track occurs in the record, the operation is terminated with Invalid Track Format 
indicated for the Unit Check ending status. 
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3.44 Write Update Key and Data 


Command Code 8D (hex) 


3-70 


The Write Update Key and Data command updates the Key and Data fields of an existing 
record. If the Key length (KL) is zero, this command operates as a Write Update Data 
command. The SP writes the existing record with the amount of data specified in the 
transfer length factor parameter of the Locate Record command (or the block size 
parameter of the Define Extent command if the transfer length factor was not specified). 
If the channel transfers less than the specified number of bytes, the remaining areas of 
the Key and Data fields are filled with zeros; if too many bytes are sent, only the 
specified number of bytes are written in the Key and Data fields. 


If the SP is oriented to a Count field when the command starts(asaresultofthe — .. 
preceding Locate Record command), processing begins on the following Key and Data 
fields. If the SP is not oriented to a Count field at the start of the command (the 
preceding command was another Write Update Key and Data command), it is oriented to 
the next Count field. It then writes the Key and Data fields of that record (not Record 0). 


If end-of-track occurs, and the next track is in the extent defined by the previous Define 
Extent command, the SP advances to the next track. Processing begins with the Key and 
Data fields of the first user record on that track (not Record 0). 


Channel End and Device End are presented when the device completes the Write € _ 
operation. When the command completes, the SP is oriented to the Data field of the 
record just updated. 


Data Address — Defines the main storage location of the data. 
Flags — Used at the discretion of the programmer. 


Count — Indicates the number of Key and Data field bytes to write. If CCW count is 
less than the sum of the key length and the data length (KL + DL), the SP pads with 
zeros for the remainder of the Key and Data fields. If CCW count is greater than that 
specified, only the indicated number of bytes are written. 


Initial Status — Normally 0. 


Chaining Requirements — Write Update Key and Data is a valid command only in the 
domain of a Locate Record that specifies a Write Data (code 01) operation. If this 
condition is not met, the command is rejected with Unit Check ending status. 
Subsequent sense information reports Command Reject with Format 0, Message 2 
(Invalid Sequence). 


If the transfer length factor (Locate Record) or block size (Define Extent) value is not 
equal to the sum of the key length and data length (KL + DL) values in the Count field of 
the record, the record is not updated. The operation ends with Unit Check status 
(Invalid Track Format). In addition, if end-of-track occurs in the record, the operation is 
terminated with Invalid Track Format indicated for the Unit Check ending status. 
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€ 3.45 Search Home Address Equal 
Command Code 39 (hex) 


Command Code B9 (hex) multitrack 


This command instructs the SP to compare the Home Address on the designated track 
with the argument read from main storage. Execution begins with a search for Index. 
When Index is detected, the cylinder and head number from main storage are compared 
with those in the track Home Address. The Home Address is validated by the ECC. 


Given that the single-track version of the command is used, the search takes place on one 
track. If the comparison is equal, Channel End, Device End, and Status Modifier are 
presented to the channel. In the event that the main storage Home-Address does not 
match the track Home Address, only Channel End and Device End are posted. 


If a multitrack search is indicated and file mask requirements are met, the search 
continues from track to track as long as the channel reissues the command. The head 
number is automatically incremented at Index until the search condition is satisfied or 
End of Cylinder (EOC) is reached. EOC is determined after the last track (14) ona 
logical cylinder is searched. An attempted head switch from Track 14 will generate the 
EOC condition. 


= ——N 


If No Record Found (for 39) or End of Cylinder (for B9) has been detected, Channel End, 
Device End, and Unit Check are presented and the channel program is terminated. The 
Cc flag byte is not transferred by the channel or compared during command execution. 


Data Address — Defines main storage location of a cylinder number and head number. 
Flags — Used at the programmer’s discretion. 


Count — Should be 4. If count is greater than 4 bytes, the search utilizes only the first 4 
bytes received by the SP. The command is terminated with Channel End and Device 
End (and Status Modifier if the comparison was equal.) For a count of less than 4 bytes, 
a comparison of the storage and track data continues until the CCW count is 
decremented to zero. Channel End and Device End are presented to the channel when 
the Home Address and the ECC bytes are read and checked. Status Modifier is 
presented with Channel End and Device End if the truncated search was satisfied. 


Initial Status — Normally 0. 


Chaining Requirements — This command must be preceded by a Seek, Seek Cylinder, 
Locate Record, Recalibrate, or Read IPL command. Also, the Search Home Address 
Equal command must not be within the domain of a Locate Record command. If these 
requirements are not met, the command is rejected with Unit Check ending status and 
the sense information reports Command Reject with Format 0, Message 2 (Invalid 
Sequence). 
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3.46 Search ID Equal 


Command Code 31 (hex) 


Command Code B1 (hex) multitrack 


3-72 


This command compares an argument in main storage with the next Count ID (CCHHR) 
on the track (including Record 0). If an equal comparison results, Channel End, Device 
End, and Status Modifier are presented to the channel. In the event that the main 
storage argument does not match the Count ID, only Channel End and Device End are 
posted. 


If a single-track search is specified, the search is confined to one track. As long as the 
channel reissues the command, the search is repeated until either the search condition is 
satisfied or two Index points are detected. Upon detection of the second Index, Channel 
End, Device End, and Unit Check are presented to the channel. The next sense 
information returned will show No Record Found as set in Sense Byte 1, bit 4. 


If a multitrack search is indicated and file mask requirements are met, the search 
continues from track to track as long as the channel reissues the command. The head 
number is automatically incremented at Index until the search condition is satisfied or 
End of Cylinder (EOC) is reached. EOC is determined after the last track (14) on a 
logical cylinder is searched. An attempted head switch from Track 14 will generate the 
EQC condition. Upon detection of EOC, Channel End, Device End, and Unit check are 
posted. The next sense information returned will show EOC as set in Sense Byte 1, bit 2. 


Data Address — Specifies main storage address of the five-byte ID (CCHHR) portion of 
a Count field. 


Flags — Used at the programmer's discretion. 


Count — Should be 5. If count is greater than 5, only the first 5 bytes from main storage 
are compared. Channel End and Device End are presented to terminate the command, 
and Status Modifier is presented if the comparison is equal. For a count of less than 5, a 
comparison of main storage and track data continues until the CCW count is 0. Channel 
End and Device End are presented to the channel when the ID and the ECC bytes are 
read and checked. Status Modifier is presented if the truncated search is satisfied. 


Initial Status — Normally 0. 


Chaining Requirements — This command must be preceded by a Seek, Seek Cylinder, 
Locate Record, Recalibrate, or Read IPL command. Also, the Search ID Equal command 
must not be within the domain of a Locate Record command. If these requirements are 
not met, the command is rejected with Unit Check ending status and the sense 
information reports Command Reject with Format 0, Message 2 (Invalid Sequence). 
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€ 3.47 Search ID High 


Command Code 51 (hex) 
Command Code D1 (hex) multitrack 


This command is identical to Search ID Equal except that a high comparison results if 
the track ID (CCHHR) is greater than the main storage argument. In this case, Channel 
End, Device End, and Status Modifier are presented to the channel. When a high 
comparison does not result, the track ID is not greater than the main storage argument 
and the CSW posts only Channel End and Device End. 


3.48 Search ID Equal or High -: 
Command Code 71 (hex) 
Command Code F1 (hex) multitrack 


This command is identical to Search ID Equal except that an equal or high comparison 
results if the track ID (CCHHR) is equal to or greater than the main storage argument. 
In this case, Channel End, Device End, and Status Modifier are presented to the channel. 
When an equal or high comparison does not result, the track ID is less than the main 
storage argument and the CSW posts only Channel End and Device End. i 
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3.49 Search Key Equal 
Command Code 29 (hex) 


Command Code AQ (hex) multitrack ~ 


This command compares the argument in main storage with the next Key field on the 
track (normally excluding Record 0, see special note). If an equal comparison results, 
Channel End, Device End, and Status Modifier are presented to the channel. In the event 
that the track contains no Key field or the Key field does not match the argument in 
main storage, only Channel End and Device End are posted. 


If a single-track Search Key Equal is indicated, the search is confined to one track. As 
long as the channel reissues the command, the search is repeated until the search 
condition is satisfied or two Index points are detected. Upon detection of the second 
Index, Channel End, Device End, and Unit Check are presented to the channel. The next 
sense information returned will show No Record Found as set in Sense Byte 1, bit 4. 


If a multitrack search is indicated and file mask requirements are met, the search 
continues from track to track as long as the channel reissues the command. The head 

number is automatically incremented at Index until the search condition is satisfied or 

End of Cylinder (EOC) is reached. EOC is determined after the last track (14) on a logical 

cylinder is searched. An attempted head switch from Track 14 will generate the EOC 
condition. Upon detection of EOC, Channel End, Device End, and Unit Check are posted. 4 

The next sense information returned will show EOC as set in Sense Byte 1, bit 2. : 


Execution of this command on a record with a key length of zero does not set a Status J 
Modifier. If followed by a chained Read Data command, the Data field read is the one in 
the next record. 


Data Address — Defines main storage location of the argument to be compared. 
Flags — Used at the programmer’s discretion. 


Count — Number of bytes in the Key field. If count is greater than the key length, the 
search operation is completed when the Key field is read. Channel End and Device End 
are presented to the channel, terminating the command. Status Modifier is presented if 
the comparison is equal. For a count equal to or less than the key length, the track and 
main storage comparison continues until the CCW count is zero. Channel End and 
Device End are presented after the Key field and subsequent ECC bytes are read and 
checked. Status Modifier is presented if the truncated search is satisfied. 


Initial Status — Normally 0. 
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Search Key Equal; Search Key High; Search Key Equal or High 


Chaining Requirements — This command must be preceded by a Seek, Seek Cylinder, 
Locate Record, Recalibrate, or Read IPL command. Also, the Search Key Equal command 
must not be within the domain of a Locate Record command. If these requirements are 
not met, the command is rejected with Unit Check ending status and the sense _ 
information reports Command Reject with Format 0, Message 2 (Invalid Sequence). 


Special Note: When this command is chained from Search ID or Read 
Count, the Key field compared is in the same record as the ID or Count field. 
Search Key Equal bypasses the Record 0 Key field unless chained from a 
Search ID command which searched Record 0. 


3.50 Search Key High 


Command Code 49 (hex) 


Command Code C9 (hex) multitrack 


3.51 


This command is identical to Search Key Equal except that a high comparison results if 
the record Key is greater than the main storage argument. In this case, Channel End, 
Device End, and Status Modifier are presented to the channel. When the Key is not 
greater than the main storage argument, only Channel End and Device End are 
presented to the channel. 


Search Key Equal or High 


Command Code 69 (hex) 


Command Code E9 (hex) multitrack 


This command is identical to Search Key Equal except that an equal or high comparison 
results if the record Key is greater than or equal to the main storage argument. In this 
case, Channel End, Device End, and Status Modifier are presented to the channel. When 
the Key is less than the main storage argument, only Channel End and Device End are 
presented to the channel. 
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3.52 Diagnostic Write Home Address J 
Command Code 09 (hex) 


This command is used to rewrite the Home Address field and define new defects that 
may have occurred on a track. Following the Home Address (HA) validity check, the SP 
orients on Index and writes Gap 1, Home Address, and ECC bytes. Bits 0 through 5 of 
the Home Address flag byte are set to 0. Channel End and Device End are presented 
after the Home Address has been written. The format for the transferred information is 
as follows: 


3890 
Byte Definition 


10-13 Defect Skip 
Displacement 
14,15 Cell Number 
16-18 Physical Address 
19 Home Address Flag 
20,21 Cylinder Address 
22,23 Head Address 
24-27 Not Used 


Note: This command is also known as Write Special Home Address and is 
sometimes classified as a Write command. 


Data Address — Defines main storage location of Home Address bytes. A 
Flags — Used at the programmer’s discretion. 

Count — 28. 

Initial Status — Normally 0. 


Chaining Requirements — Unit Check ending status (sense information reporting 
Command Reject with Format 0, Message 2) occurs if one of the following conditions is 
encountered. 


¢ The Diagnostic Write Home Address command is not preceded by a Seek, Seek 
Cylinder, Locate Record, Read IPL, or Recalibrate command 


e This command is outside the Locate Record domain and the currently accessed 
track is in the device-support address space. 


¢ The Diagnostic Write Home Address command is in the domain of a Locate Record 
that does not specify a Format Write (code 03) operation and Index orientation 
(Byte 0, bits 0 and 1 are ‘11’). 
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c When Diagnostic Write Home Address is the last command in a chain, the remainder of 
the track will be erased. For commands other than Write Record 0 chained from 
Diagnostic Write Home Address, the command will be executed after the track is erased. 


When outside the domain of a Locate Record command, this command is valid only if the 
channel program is operating with Diagnostic Authorization and allows writing Home 
Address. When the file mask does not specify Diagnostic Authorization (bits 5 and 6 are 
not ‘10’), the operation is rejected with Unit Check ending status. Sense data reports 
Command Reject with Format 0, Message 5 (Diagnostic Command not permitted). Ifthe 
file mask does not allow all writes (bits 0 and 1 are not ‘11’), the operation is rejected 
with Unit Check ending status. Sense information reports Command Reject with Format 
0, Message 2. 
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3.53 Diagnostic Sense/Read 
Command Code C4 (hex) 


This command transfers bytes of diagnostic information to the channel depending on the 
subcommand specification indicated in Byte 0 of the preceding Diagnostic Control 
command. The format of the diagnostic data may be any one of the following 
subcommands in Byte 0 of the Diagnostic Control command: 


Byte 0 Subcommand of Diagnostic Control Command 
01 Locate Data Checks 

06 Select Subsystem Data 

07 Select Trace 

OD Start Application 


If the preceding Diagnostic Control command does not indicate one of these 
subcommands, zeros are returned by the Diagnostic Sense /Read command. 


Note: This command is intended for maintenance purposes only. Any other use 
may produce unpredictable results. 


Whenever Diagnostic Sense /Read successfully executes, Channel End and Device End 
are posted following the transfer. 


Data Address — Defines main storage location for first byte of diagnostic information. 
Flags — Used at the programmer’s discretion. 

Count — 6656 (maximum) 

Initial Status — Normally 0. 


Chaining Requirement — Diagnostic Sense /Read is not valid in the domain of a 
Locate Record command. If it is in a Locate Record domain, it is rejected with Unit 
Check ending status and subsequent sense information reports Command Reject with 
Format 0, Message 2 (Invalid Sequence). 


Diagnostic Sense /Read must be preceded by a Diagnostic Control command in the same 
chain and it must be chained directly from the Diagnostic Control command except for 
the following: 


¢ when the Diagnostic Control subcommand is ‘01’, the Diagnostic Sense /Read 
command must be chained from a Read command. 


¢ when the Diagnostic Control subcommand is ‘OD’, the Diagnostic Sense /Read 
command must be chained from a Diagnostic Write command. 


If these conditions are not met, the command is rejected with Unit Check ending status. 
The sense information reports Command Reject with Format 0, Message 2. 
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Diagnostic Read Home Address 


3.54 Diagnostic Read Home Address 


Command Code 0A (hex) 


This command transfers the defect skip displacement bytes, cell number, physical 
address byte, flag, identifier (CCHH), and ECC bytes for the Home Address field to main 
storage. ECC bytes following the Home Address are used to validate the field. 

Command retry is initiated by the SP if Data Overrun or Data Check error conditions are 
encountered. Channel End and Device End are presented after reading the Home 
Address ECC bytes. 


Note: This command is also known as Read Special Home Address and is 
sometimes classified as a Read command. 


Data Address — Defines main storage location of the first Home Address byte. 
Flags — Used at the programmer’s discretion. 

Count — 28. 

Initial Status — Normally 0. 


Chaining Requirement — Unit Check ending status (sense information reporting 
Command Reject with Format 0, Message 2) occurs if on? of the following conditions is 
encountered. 


¢ The Diagnostic Read Home Address command is not preceded in the command 
chain by a Seek, Seek Cylinder, Locate Record, Read IPL, or Recalibrate command. 


e This command is in the domain of a Locate Record that does not specify a Read 
(code 16) operation and Index orientation (Byte 0, bits 0 and 1 are ‘11’). 


When outside the domain of a Locate Record command, the Diagnostic Read Home 
Address comman4d is valid only if the channel program is operating with Diagnostic 
Authorization. When the file mask does not specify Diagnostic Authorization (bits 5 and 
6 are not ‘10’), the operation is rejected with Unit Check ending status. Sense data 
reports Command Reject with Format 0, Message 5 (Diagnostic Command not permitted). 
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3.55 Diagnostic Control 


Command Code F3 (hex) 


This command transfers, from main storage to the SP, four bytes of Diagnostic Control 
parameters that specify a service or information request. Following the transfer, the SP 
validates the subcomman4d, its modifiers, and the settings for Bytes 2 and 3 (Bytes 2 and 
3 should equal 0). Except when the subcommand is Set Guaranteed Path, Channel End 
is presented after the parameter list is validated. Device End is presented after normal 
termination. Channel End and Device End can occur together. 


The four bytes of Diagnostic Control Parameters are formatted as follows: 

Byte 0 — Subcommand 

Byte 1 — Subcommand Modifier 

Bytes 2 and 3 — Must be zeros. 

Valid subcommands for this subsystem include the following hexadecimal values 


specified in Byte 0 of the Diagnostic Control command. Any other value results in Unit 
Check ending status. 


Hex Value 
of Byte 0 Subcommand 

01 Locate Data Checks 
02 Inhibit Write 
04 Set Guaranteed Path 
06 Select Subsystem Data 
07 Select Trace 
08 Enable Write 
oc Unfence 
OD Start Application 


These values are the only ones valid for Byte 0. If Byte 0 does not contain a valid value, 


and Bytes 2 and 3 are not zeros, the command is rejected with Unit Check ending status. 


The sense data contains Command Reject with Format 0, Message 4 (Data Value not as 
required). 


Subcommand Descriptions 


3-80 


Locate Data Checks (01) — This setting allows the programmer to trace Data Checks. 
When this subcommanzd is specified, all Data Checks that occur during execution of a 
Read command will be processed without raising Unit Check or initiating a command 
retry sequence. Information about the Data Checks, detected in the first field that 
yielded a Data Check, will be entered in a table generated by the Locate Data Checks 
subcommand. This table will be transmitted to the host via the Diagnostic Sense/ Read 
command. 
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Diagnostic Control 


| Unit Check ending status, sense information reporting Command Reject with Format 0, 

Ss Message 2, results if this Diagnostic Control command specifying a Locate Data Checks 
subcommanzd is not chained to a Read-type command and then followed by a Diagnostic 
Sense /Read command. 
Inhibit Write (02) — This setting prevents all subsequent Write operations by the SP 
on the paths that are specified by subcommand modifiers (Byte 1). After issuing this 
subcommand for a path, any Write commands and Locate Record commands specifying 
write-type operations which attempt to write on this path are rejected with Channel End, 
Device End, and Unit Check. Unit Check indicates an Equipment Check (Byte 0, bit 3) 
and Write Inhibited (Byte 1, bit 6) in the sense bytes. 


Byte 1 is the subcommand modifier and specifies the SP that will be governed by the 
Inhibit Write subcommand. The format of Byte 1 is as follows. 


Modifier Effect 
80 Inhibits all Write operations to all devices through the selected SP. 


40 Inhibits all Write operations to all devices through the selected SP from the 
selected channel path. On receiving this modifier, the SP first checks to 
determine whether the Inhibit Write subcommand is active on any other 
channel path. If Inhibit Write is in effect for another channel path, all 

LOM Write operations are inhibited for the selected SP. 


20 Inhibits all Write operations to all devices through the selected SP. 


& When Write operations are inhibited on a path, the path remains inhibited until one of 
the following occurs: 


e¢ A Diagnostic Control command specifies the Enable Write (08) subcommand. 

e System reset (resets Inhibit Write for the channel path in the receiving SP). 

¢ IML (resets all Inhibit Write controls in the SP). 

e Reset switch for the SP is activated (resets all Inhibit Write controls in the SP). 


Bytes 2 and 3 of the Inhibit Write subcommand must be zeros. If not zeros, the 
Diagnostic Control command is rejected with Unit Check and sense bytes containing 
Command Reject with Format 0, Message 4 (Data Value not as required). 


Set Guaranteed Path (04) — When the specified SP receives this subcommand in the 
Diagnostic Control command, the command performs the functions of the Suspend 
Multipath Reconnection command (see Section 3.14 for a description of this command). 
Byte 1, the subcommand modifier for Set Guaranteed Path, must be set to zeros. If Byte 
1 is not valid, the command is rejected with Unit Check ending status and sense 
information reporting Command Reject with Format 0, Message 4. 


For this subcommand of the Diagnostic Control command, the SP presents Channel End 
and Device End status when it establishes a path. 
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3-82 


Select Subsystem Data (06) — This subcommand and its modifier are used to identify 

the subsystem trace that is to be sent by the immediately following Diagnostic Read a 
commands. For the 3890-2 subsystem, Byte 1 (subcommand modifier) set to ‘01’ is the 

only valid value. This subcommand modifier is defined as “Query Trace” and can be used 

to provide the IDs of all traces currently stored in the subsystem, along with their 

lengths and content flags. 


Bytes 2 and 3 must be set to zero. If not zero, the command is rejected with Unit Check 
ending status and sense bytes containing Command Reject with Format 0, Message 4. 


Select Trace (07) — This subcommand specifies that the trace, identified by the 
modifier of the Select Subsystem Data subcommand or, alternatively, the only available 
trace, will be sent to the channel by the immediately following Diagnostic Sense /Read 
commands). The trace can be up to 24 blocks of 1024 bytes. 


If any other command is received before all of the trace data is read, or a Diagnostic 
Sense /Read command is received after all the trace data has been read, the command is 
rejected with Unit Check ending status. The sense information reports Command Reject 
with Format 0, Message 2 (Invalid Sequence). 


Enable Write (08) — This setting allows the SP to cancel the effect of any previous 
Inhibit Write subcommands set by this SP, thus enabling it to process all Write 
commands normally. Parameter Bytes 1 through 3 are not used in this case and must be 
set to zero. If not zeros, the command is rejected with Unit Check ending status and 
sense bytes containing Command Reject with Format 0, Message 4. 


Unfence (0C) — This subcommand removes fences. The specification in Byte 1 defines 


what to unfence as indicated below. > 
Bits Significance 
0-3 Unfences one or more storage paths where each bit corresponds to the 


respective SP (0, 1, 2, or 3). 


4 Unfences a device. The addressed device is unfenced from all SPs in the 
subsystem. Bits 0 through 3 must be zeros when bit 4 is set to 1. 


5-7 Reserved. These bits must be set to zeros. 


When this subcommand is used, at least one bit in bits 0 through 4 must be set and bits 5 
through 7 must be zeros. If bit 4 is set to 1, bits 0 through 3 must be zeros. When Byte 1 
is not valid, the command is rejected with Unit Check status. The sense bytes contain 
Command Reject with Format 0, Message 4. 


If channel operations are queued in the SP that is unfenced, the operations are 
terminated with status that includes Unit Check. The sense data contains Format 0, 
Message 9 (Storage Path Restart). 


The SP presents Channel End when it receives the parameters. Device End occurs when 
the unfencing operation is complete although Channel End and Device End can occur 
together. 
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Start Application (0D) — This subcommand prepares the subsystem for a Diagnostic 
= Write command which has a Support Facility Application identifier, the device type, and 
parameters for the application. A Diagnostic Sense /Read can be chained from the 
Diagnostic Write command when status or data from the application is needed. 
Byte 1, the subcommand modifier, determines the number of parameter bytes that the 
following Diagnostic Write command expects to transfer. If Byte 1 is zero, 256 parameter 
bytes are expected. If Byte 1 is not zero, it contains the number of expected parameter 
bytes. 


Only a Diagnostic Write command can be chained from a Diagnostic Control command 
with the Start Application subcommand. If any other command is received, the 
command is terminated with Unit Check ending status. The sense information reports 
Command Reject with Format 0, Message 2. 


Data Address — Defines the main storage location of the Diagnostic Control 
parameters. 


Flags — Used at the programmer’s discretion. 


Count — 4. The SP expects four bytes of parameters. If the channel sends less than 

four bytes, the command is rejected with Unit Check ending status. The sense 

information reports Command Reject with Format 0, Message 3 (CCW Count less than 
fis required). 


Initial Status — Normally 0. 


 S Chaining Requirements — The Diagnostic Control command is not valid in the 
domain of a Locate Record command. If it is received in the Locate Record domain, it is 
rejected with Unit Check ending status. The sense information contains Command 
Reject with Format 0, Message 2 (Invalid Sequence). 


This command cannot be preceded in a chain by a command that specifies or implies 
cylinder and head selection — Locate Record, Seek, Seek Cylinder, Seek Head, Read IPL, 
or Recalibrate command. If Diagnostic Control is preceded with one of these commands, 
the command is rejected with Unit Check ending status (sense information reports 
Command Reject with Format 0, Message 2). 
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3-84 


All subcommands require either Diagnostic or Device Support Authorization, or that the 
command be the first in a chain. If the subcommand does not have the correct 
authorization, the command is rejected with Unit Check ending status. The sense 
information contains Command Reject with Format 0, Message 5 (Diagnostic Command 
not permitted). The following subcommands are allowed only in a channel program that 
is operating with Diagnostic Authorization or Device Support Authorization. 

¢ Locate Data Checks 

¢ Inhibit Write 

¢ Set Guaranteed Path 

¢ Enable Write 

¢ Unfence 


¢ Start Application 


The Select Subsystem Data or Select Trace subcommand must be the first command in a 
chain or be chained directly from a Suspend Multipath Reconnection that is the first 


_command in a chain. If not first in a chain, the command is rejected with Unit Check 
“ending status. The sense information contains Command Reject with Format 0, Message 


2 (Invalid Sequence). 


Any additional chaining requirements that must be observed when using subcommands 
of the Diagnostic Control command are provided in the preceding subcommand 
descriptions. 
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Cc 3.56 Diagnostic Write 


Command Code 73 (hex) 


The Diagnostic Write command transfers data from the channel to the subsystem. The 
amount of data and the content of the data that the Diagnostic Write command transfers 
is determined by the Diagnostic Control command that must precede it. The format of 
the.data for the command is as follows. 


Byte Content of Data Transferred by Diagnostic Write 

0 Application identifier — Not used and must be zero. 

1 Device type — Not used and must be zero. 

2-257 Application data — Provides the data content to be transferred. The number 
Bo of bytes of this application data is determined by the setting of the parameters 


in Byte 1 of the preceding Diagnostic Control command. If parameter Byte 1 
of the Diagnostic Control command is 0, 256 bytes of application data are read 
from the channel. If parameter Byte 1 of the Diagnostic Control command is 
not 0, Byte 1 then contains the number of bytes to be read from the channel. 
This number can be from 1 through 255 bytes. 


The SP presents Channel End when it receives data from the channel. It presents 

Device End when the operation completes. Channel End and Device End can occur 

together. If a Diagnostic Sense / Read command follows the Diagnostic Write command, 
Yer the resultant data from the application sent to the storage path is transferred to the chan- 
uw 3 nel. 


Data Address — Defines the main storage location of the data. 
c Flags — Used at the programmer’s discretion. 


Count — Up to 258 bytes. If the channel transfers more bytes than expected, only the 
expected number of bytes are accepted. If too few bytes are transferred, the command is 
rejected with Unit Check ending status. Sense information reports Command Reject 
with Format 0, Message 3 (CCW Count less than required). 


Initial Status — Normally 0. 


Chaining Requirements — The Diagnostic Write command must be preceded in the 
same chain by a Diagnostic Control command with the Start Application (OD) subcom- 
mand. In addition, it must be chained directly from the Diagnostic Control command or 
another Diagnostic Write command. If these conditions are not met, the command is 
rejected with Unit Check ending status. Sense information reports Command Reject 
with Format 0, Message 2 (Invalid Sequence). 


A Diagnostic Sense / Read or another Diagnostic Write command can be chained from this 
command. If Diagnostic Write commands are chained directly together, each must trans- 
fer the same number of bytes specified by the Diagnostic Control command. When 
chained directly together, status and data from all but the last Diagnostic Write com- 
mand are lost. 
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Perform Subsystem Function 


3.57 Perform Subsystem Function 
Command Code 27 (hex) 


This command provides one of two functions, depending on the function order specified in 
Byte 0 (see Function Order Descriptions below). It can be executed on devices with 
equipment checks or intervention required conditions. 


Bytes 0 and 1 are common to the two valid orders of this command where Byte 0 specifies 
the hex value of the selected order and Byte 1 is a flag byte. Valid values for Byte 0 are 


as follows: 

Hex 

Value Byte 0 Order for Perform Subsystem Function Command 
00-17 Not valid for this subsystem. 

18 Prepare for Read Subsystem Data. 

19-1A Not valid for this subsystem. 

1B Set Special Intercept Condition. 

1C-FF Not valid for this subsystem. 


The flag byte, Byte 1, contains information specific to the particular function order 
selected in Byte 0. For the two valid orders of this command on the 3890-2 subsystem, 
Byte 1 must be zero. If not zero, the command is rejected with Unit Check ending status 
and the sense information contains Command Reject with Forn:at 0, Message 4 (Data 
Value not as required). 


Function Order Descriptions w 


Prepare for Read Subsystem Data (18) — This order stores data in an internal buffer 
of the SP for subsequent retrieval by a Read Subsystem Data command. 


The order requires 12 parameter bytes, including Byte 0, which specifies selection of the 
order (18). The significance of Bytes 1 through 11 is as follows: 


Bytes Significance 
1 Flag Byte — Must be zero. Any other value results in rejection. 
2-5 Reserved — Must be zeros. 
6 Suborder defining the data to place in the buffer. 
¢ 00 = The status of the SPs in the subsystem. This is the only valid value 
for Byte 6. 
¢ 01-FF= Not used and these values are invalid. 
7-11 Not used and must be zeros. 
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The Perform Subsystem Function command with this order specified requires 12 

S parameter bytes (Byte 0 specifies ‘18,’ the function order). If these parameter bytes are 
specified with invalid values, the command is rejected with Unit Check ending status 
(sense bytes contain Command Reject with Format 0, Message 4). 


The SP presents Channel End after it validates the parameters. Device End occurs when 


the data is available although, in most cases, Channel End and Device End occur 
together. 


Only a Read Subsystem Data command can be chained from the Perform Subsystem 
Function command that specifies this order. If any other command is chained from the 
command with this order, it is rejected with Unit Check ending status. The sense 
information reports Command Reject with Format 0, Message 2 (Invalid Sequence) and 
the contents of the buffer can be lost. The buffer’s content can also be lost if the order is 
not chained but, in this case, the SP does not report the error (see Section 3.59, Read 
Subsystem Data). 


Set Special Intercept Condition (1B) — This order sets a condition in the subsystem 
that causes the 3898-2 to reject specific commands for the addressed device. 


The order applies only to those paths with the same path group ID (regardless of the 

grouping status) for the addressed device that receives the next specific command. Only 

the next specific command received for this address on a path with the specified path 

group ID is rejected with Unit Check ending status. The sense data reports Command 

Reject with Format 0, Message F. The SP presents Channel End and Device End after ~ 
processing completes. 


om 


& On this subsystem the following two commands can be intercepted and rejected by 
specifying this order: 


¢ Perform Subsystem Function with function order ‘1B,’ Set Special Intercept 
Condition, and 


e Diagnostic Control with any option. 


This order requires two parameter bytes; a valid order byte (Byte 0 = 1B) and the flag 
byte. The flag byte is Byte 1 and must be zero. If the flag byte is not zero, the command 
is rejected with Unit Check ending status. Sense information contains Command Reject 
with Format 0, Message 4 (Data Value not as required). 


If the 3898-2 receives less than two parameter bytes for this command and function 
order, the command is rejected with Unit Check ending status. Sense bytes contain 
Command Reject with Format 0, Message 3 (CCW Count less than required). 


If a device is operating in this condition for a channel path, and the status includes 
Attention for this device for this path, the SP adds Unit Check to that status. This added 
Unit Check status does not reset the device to normal! operation. 


If this command is directed to a device on an interface for which a path group has not 
been established, the command is rejected with Unit Check ending status. The sense 

_ bytes contain Command Reject and Environmental Data Present with Format 0, 
Message F. 
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System resets follow normal path group rules for resetting the device to normal 

conditions. Processing this command with this function order or processing a Diagnostic J 
Control command resets the addressed device to normal conditions. However, processing 

a Selective Reset, a Set Path Group ID, or a Suspend Multipath Reconnection: command 

does not reset the addressed device to normal conditions. 2 

This command and function order specification must be the first command in a chain or 

be immediately preceded by a Suspend Multipath Reconnection command that is the first 

command in achain. If not, the command is rejected with Unit Check ending status 

(Invalid Sequence in the sense bytes). Also, if any command is chained from this 

command, it is rejected with Unit Check ending status. 


Data Address — Defines the main storage location of the function order. 
Flags — Used at the programmer’s discretion. 


Count — Variable depending on the number of parameter bytes associated with the 
specified function order. If the channel sends more bytes than the order requires, the SP 
accepts only the number of bytes required by the order. If the channel sends too few 
bytes to satisfy the requirements of the order, the command is rejected with Unit Check 
ending status (sense bytes indicate CCW Count less than required). 


Initial Status — Normally 0. 


Chaining Requirements — The Perform Subsystem Function command is not valid in 
the domain of a Locate Record command. If it is received in the Locate Record domain, it 
is rejected with Unit Check ending status. The sense information contains Command 

Reject with Format 0, Message 2 (Invalid Sequence). 2 


All function orders of the command require a cache subsystem except for ‘18’ and ‘1B’; 
therefore, the command is rejected with Unit Check ending status if any other order or 
value is specified. The sense information reports Command Reject with Format 0, 
Message 4 (Data Value not as required). 
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_ Read Configuration Data 


c 3.58 Read Configuration Data 
Command Code FA (hex) 


A description of this command will be supplied at a later date. 
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Read Subsystem Data 


3.59 Read Subsystem Data J 
Command Code 3E (hex) 


The Read Subsystem Data command causes the 3898-2 to send the data requested by the 
Perform Subsystem Function command. The format of the data depends on the suborder 
indicated in Byte 6 of the Prepare for Read Subsystem Data order of the Perform Subsys- 
tem Function command (see Section 3.57, Perform Subsystem Function). For the 3890-2 
subsystem, the only valid suborder in Byte 6 is ‘00,’ which indicates that the Read Sub- 
system Data command is to send Storage Path Status data. 


When the Perform Subsystem Function command has the order code Prepare for Read 
Subsystem Data with Byte 6 indicating ‘00,’ a 16-byte record containing 4 bytes of path 
status for each storage path is read. The contents of this record are shown below; the 
status of each storage path is indicated in the following 4-byte increments of the 16-byte 
record. 


¢ Bytes 0 - 3 describe Storage Path 0 

e Bytes 4 - 7 describe Storage Path 1 

¢ Bytes 8 - 11 describe Storage Path 2 
¢ Bytes 12 - 15 describe Storage Path 3 


a 


0, 4, 8,or 12 Storage Path/Device Status 2 
0 = Storage path is not installed on subsystem. 
1 = Bytes 1 through 3 (or 5 - 7,9 - 11, or 13 - 15) contain valid 
values. 


Device attaches through this storage path. 

0 = This storage path is enabled. 

1 = The following three bytes are not valid because the storage 
path is disabled. 


Device has permanent or internal fence from this storage path 
(two-way fences are excluded). 


Command received on this path. 


ID of channel requesting status (0 = Channel A, 1 = Channel B, 
1,5,9,0r13 etc.). 


2,6, 10, or 14 Bit map of channels configured in this storage cluster. 


3,7,11,0r15 Bit map of Channel Enabled/Selected switches. 


Bit map of channels fenced from this storage path. 
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Read Subsystem Data 


Cc When data transfer is complete, Channel End and Device End are presented. 
Data Address — Defines the main storage location for the data. 
Flags — Used at the programmer’s discretion. - 


Count — Specifies the number of bytes that the Perform Subsystem Function command 
requests. If the CCW count is more than the number of bytes specified for the data, only 
the specified number of data bytes are transferred. If the count is less than the message 
requested, only the specified number of bytes are transferred. 


Initial Status — Normally 0. 


Chaining Requirements — The Read Subsystem Data command is not valid in the 
domain of a Locate Record command. If it is received in the Locate Record domain, it is 
rejected with Unit Check ending status. The sense information contains Command 
Reject with Format 0, Message 2 (Invalid Sequence). 


This command must be chained from a Perform Subsystem Function command which 
specifies a Prepare for Read Subsystem Data order. If not in this chain, the command is 
rejected with Unit Check ending status (sense information reports Command Reject with 
Format 0, Message 2). In addition, only a Perform Subsystem Function command can be 
chained from the Read Subsystem Data command. Any other command chained from 

( a Read Subsystem Data is rejected. 
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Test /O 


3.60 Test I/O J 


Command Code 00 (hex) 


This command transfers one status byte from the SP to the channel. This byte is 
normally set to 0 except when stacked or pending status is posted in the SP or drive. 
Test I/O command is a system/channel instruction, not a CCW. The subsystem treats the 
command as an immediate command. 


Data Address — Defines main storage location where status byte is to be transferred. 
Flags — Not used. 


Count — 1. 
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Section 4 
Track Format 


4.1 Introduction 


Designed to support the command description, this section of the manual presents the 
track format for the drives that attach to the 3898-2. The reader will find this 
information particularly useful in relation to the Read, Write, Diagnostic Read Home 
Address, and Diagnostic Write Home Address commands. In addition, Section 4 briefly 
discusses defect skipping and alternate tracks, two design features that minimize the 
impact of media flaws. 


4.2 Track and Record Format 


The track and record format for 3890 devices is illustrated in Figures 4-1. The track 
starts with a track Index, followed by a Home Address and a series of variable length 
data records in a count, key, data format. Each of these items is separated from the next 
by a gap — an area that contains filler patterns and structures used to orient’the drive. 
The various track fields are as follows: 


¢ Home Address Field. This area contains information that identifies the track. 
The Home Address is composed of a skip defect field which contains the absolute dis- 
placement of the defect skips permitted for the track, the cell number of the field, the 
physical address (the cylinder and head address of the track), and a Home Address 
flag which identifies track status. The Home Address also includes an identifier for 
the cylinder and head, zero-fills, and a set of twelve ECC bytes which contain an 
Error Code used to recover data if the field is transmitted in error. 


¢ Count Field. This field provides identifying and control information for a record. 
All Count fields have the same general format as the Home Address field with a 
record number, a key length, and a data length appended. 


¢ Key Field. This field is a variable length area that, if used, furnishes indices for 
the Data field. The Key field contains twelve ECC bytes in addition to user informa- 
tion. Inclusion of Key fields on a track is optional; the Key field is generally omitted 
from Record 0. 


¢ Data Field. The Data field contains user data and is variable in length. Twelve 
ECC bytes are appended to this field. As an exception to this general format, the 
Record 0 Data field is usually a fixed length of eight bytes and does not store cus- 
tomer data. Instead, the eight bytes of the Record 0 Data field contain information 
used by the CPU. Also, if the Data field is part of an End-of-File record (last record 
on the track), the field is one byte of zero plus ECC. Data length for an End-of-File 
record is always expressed as zero. 
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Defect Skipping and Alternate Tracks 


¢ Gaps. The 3890 utilizes three different gap types as record and field separators. 

The track index is followed by a gap (Gap 1) field that contains 504 bytes and in- 2 
cludes fast sync, alignment bytes, and a sync byte. Each record is separated from the 

next by a Gap 3 field which contains 216 bytes and includes an address mark, fast 

sync, alignment bytes, and a sync byte. The fields within each record are separated 

by a Gap 2 field — 224 bytes including fast sync, alignment bytes, and a sync byte. 

The Gap 2 field separates Bome Address from the Record 0 Count field. This field 

contains 248 bytes including fast sync, alignment bytes, and a sync byte. 


4.3 Defect Skipping and Alternate Tracks 


The subsystem control functions provide defect skipping for each track; this feature 
allows media faults to be logically avoided during most command operations. A defect 
skip consists of 96 bytes (3 cells) of zeros and synchronization patterns written over the 
defective area of the track and referenced in the Home Address and Count Fields. When 
the microcode reads the Home Address or Count fields, it determines the location of the 
defect skip and avoids that area. The drive permits seven defect skips per track; tracks 
containing more that seven defects are considered defective. 


In addition to defect skipping, the disk provides 15 alternate tracks (one cylinder). These 

tracks can be linked to user data tracks in the event that a data track proves defective. 

Once the data track and the alternate track are linked, all operations normally routed to 

that track will be routed to the alternate. Thus, data for the original track will be stored ( 
on the alternate. 
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Figure 4-1. Track Format 
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« Section 5 
Error Handling 


5.1 General Description 


The 3898-2 Cluster Control Unit is equipped with the logic to perform various error 
handling functions for the subsystem. Error handling functions serve the subsystem by 
ensuring the integrity of the data passed to the channel, minimizing the number of 
command rejections, and maintaining records of subsystem usage and error incidences 
= 4 for performance evaluation by the customer and CE. The error handling capabilities of 
the 3898 include three main functions: the error function, the command retry function, 
and the statistical/error recording function. The following paragraphs describe the first 
two of these functions; the statistical/error recording function is covered in Section 6. 


5.2 Error Function 


The disk drive data error function is inherently linked to the generation of the Error 


ee Correction Code (ECC) at the controller level. Each time that the SP receives a write 
ae command, it generates a series of bytes (see Figure 4-1) which are appended to the field 
written on the track. When the field is subsequently read, the 3898 examines it for 
errors. If an-error is detected in the Home Address, Count, Key, or Data fields, the SP 
& handles the error by performing a retry for the command in question. Given a correctable 


Data Check in one of these fields, the 3898 applies an error algorithm to reconstruct the 
original data. The corrected data is then transferred to the CPU. 


5.3 Command Retry Function 


The command retry function can allow several different types of errors. In essence, 
command retry consists of repeating a command a prescribed number of times or until 
the operation is successfully completed. During the course of the retry sequence the 
channel releases the 3898-2. If the command fails throughout the retry sequence, the 
error is considered unrecoverable and is logged to the system error records. Command 
retry sequences are executed if a Read or Search command produces a correctable Data 
Check, an uncorrectable Data Check is detected, an assigned alternate track is indicated 
in the Home Address/Record 0 Count field of a defective primary, or a seek error/seek 
incomplete occurs. The command retry function is also activated when a Command 
Overrun is present, a Data Overrun occurs, or a track pad operation is in progress for the 
selected device (in this case a command retry allows the device to be released by the 
channel). 
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Section 6 
Sense Data 


6.1 General Description 


Sense data comprises 32 bytes of information that define device or subsystem conditions. 
This data is gathered from the usage and error counters when one of the counters 
overflows; the information is then transmitted to the CPU as part of the statistical/error 
recording function. When the sense bytes are transferred to the CPU, they are stored in 
the system error and statistical logs (SYS1.LOGREC) and may be retrieved by executing 
the Environmental Recording, Editing, and Printing (EREP) program. 


The EREP program formats the sense data in accordance with the type of information 
presented in the sense bytes. For instance, certain sense reports are statistical in nature. 
These reports record the number of accesses, bytes read, etc., for a given device over a 
period of time. Statistical reports also display the number of Command Overruns and 
Data Overruns experienced during the time interval. Other types of sense reports are 
specific in nature, referring to a particular error occurrence and describing the 
device/subsystem condition at the time of the failure. 


coom™ 


The subject of the report presented by EREP is determined by the format sense byte. 
The format sense byte defines the information stored in the sense byte group as follows; 


c the customer should note that not all subsystems utilize all formats. 
Format Definition 
0 Program or system checks 
1 Device equipment checks 
2 Cluster Control equipment checks 
3 Storage Path control checks 
4 Data checks 
5 Data checks with PCI fetch mode 
6 Usage statistics/overrun errors 
7 Storage Path check 1 errors 
8 Storage Path check 2 errors 
9 Device read, write, and seek checks 


The 32-byte sense information provides a 24-byte compatibility reporting format to retain 
compatibility with other disk subsystems that report 24 bytes of sense data. Byte 27 
with bit 0 set to 1 indicates that the first 24 bytes of sense data are comparable. Sense 
information reported as 32 bytes appends 8 additional bytes to the first 24 and these 8 
bytes contain the same sense information for all formats (0 through 9). 
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Sense Data 


For the user’s reference, the following text presents information on Sense Bytes 0 

through 7 as reported by the 3890 subsystem. Sense Bytes 8-31 detail conditions , 
according to one or more of the formats indicated above and have been omitted from this a 
discussion. The description of Sense Bytes 0 through 7 is supported by Tables 6-1 

through 6-3. 
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Summary of Sense Bytes 0 Through 7 


Table 6-1. Summary of Sense Bytes 0 through 7 


Sense Bytes 
Byte 0 Byte 1 Byte 2 Byte 3 Byte 4** Byte 5*** | Byte 6**** Byte 7 
(Format 1, 
2, 6, 7, 8, 
and 9)* 


Command | Permanent | Request Controller Path in Low-Order | High-Order Format 
Write ID (Path Use Cylinder Cylinder Decode 

Inhibit Identifier) Address Address (See 
Cylinder 128 2048 Table 6-2) 


Invalid Correctable 
Track 


Format 


Intervention 
Required 


Cylinder 64 | High-Order 
Cylinder 
Address 
1024 


2 Channel End of Logical Cylinder 32 | High-Order 
Bus Out Cylinder Device Cylinder 
Parity Address Address 
Check 256 


3 | Equipment | Message Environ- Cylinder 16 Head 
Check to mental Data Address 
Operator Present 128 


No Record 
Found 


Message 
Code 
(See 

Table 6-3) 


0 
(Not Used) 
5 Overrun File imprecise 
Protected Ending 
(Compatiblity 
Bit) 
0 


Write 0 
(Not Used) Inhibited | (Not Used) 
7 Imprecise 
Ending 


Cylinder 8 Head 
Address 
8 
Cylinder 4 Head 
Address 
4 
Cylinder 2 Head 
Address 
2 
Cylinder 1 Head 
Address 
1 


*For Formats 0 and 3, Byte 3 is set to 00. The Controller ID is 3. Ifeither Byte 1, Bit 7 or Byte 1, Bit 5 is set to 1, Byte 3 
in Byte 20 for Format 0. For Formate 4 and 5, the Controller indicates the number of records remaining to be 
ID is in Byte 14 and Byte 3 is set to 00 except for condition 1 processed in the Locate Record domain. 
indicated below. x : . . 
Set to zero when the SP is not reporting device status. 
1. If Byte 2, Bit 3 is 1 and Byte 1, Bit 7 is 0, Byte 3 
indicates the number of retries attempted by the SP fora ***T¢ set to 01 for Format 6, byte indicates Command Overrun 
record with a temporary data check. counter overflow. 
2. hcl es - eae : contains the Controller ID for **** IC set to 01 for Format 6, byte indicates Data Overrun 
bd ae ae, ° counter overflow. 
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Sense Byte 7 Format Decode 


Table 6-2. Sense Byte 7 Format Decode 


Type of Format Decode 
Decode 
Program or System Checks — This format is generated when Sense Bytes 0-7 describe 
the error or unusual condition caused by a program or system error. 


Device Equipment Checks — This format is generated under the following conditions: 
* Detection of drive, SP/device interface, or SP equipment checks (Sense Byte 0, Bit 3, 
Equipment Check is also set). 
¢ Detection of a device seek check (Sense Byte 0, Bit 3, Equipment Check is also set). 
¢ Off-loading of error log information occurred during a successfully retried seek (Byte 
2, Bit 3, Environmental Data Present is also set). A seek error was indicated by the 
message bits in Sense Byte 7. 
¢ No online indication in the status (Sense Byte 19, Bit 4, Format 1). Sense Byte 0, 
Bit 1, Intervention Required is also set. 


Storage Path Control Checks — This format is generated to report miscellaneous 
conditions recorded by the SP in question. These conditions include power-up errors that 
occur on other SPs, detection of high temperature or power supply failures, and trace 

table save operations. 


Data Checks — This format is generated under the following conditions: 
¢ Detection of an uncorrectable Home Address, Count, Key, or Data field Data Check 
after retry failed. 
¢ Detection of a Home Address, Count, Key, or Data field Data Check while the 
subsystem was operating in a diagnostic mode. The Data Check was successfully 
recovered. 
« Detection of a Home Address, Count, Key, or Data field Data Check while the 
subsystem was in logging mode. The Data Check was successfully recovered. 
« Detection of a Home Address, Count, Key, or Data field Data Check. The error was 
successfully recovered using head offset during the subsystem retry sequence. 


continued 
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ea Sense Byte 7 Format Decode 


& Table 6-2. Sense Byte 7 Format Decode (continued) 


Format Type of Format Decode 
Decode 


Data Check with PCI Fetch Mode — This format is generated on detection of a 
correctable Data Check in the Key or Data field that was successfully recovered via 
retry with PCI Fetch Mode set in the file mask. 


Usage/Error Statistics — This format is generated if the usage statistics or overrun 
errors require off-loading because of a counter-overflow condition or because a Read 
and Reset Buffered Log command has been issued. 


Storage Path Check 2 — This format is generated when a Check-2 condition is 
detected by the SP. 


Device Read, Write, and Seek Checks — This format is generated under the following 
conditions: 
¢ Detection of a device seek check (Byte 0, Bit 3, Equipment Check and is also set). 
¢ Off-loading of error log information occurred during a successfully retried seek 
(Byte 2, Bit 3, Environmental Data Present is also set). 


7 Storage Path Check 1 — This format is generated when a Check-1 condition is 
detected by the SP. 
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Sense Byte 7 Formats and Message Codes 


Table 6-3. Formats and Message Codes in Sense Byte 7 


Format 
(Bits 0-3 
Hex) 


(Device Sense 


Byte 1, Bit 
3=1) 


Equipment 
Check/ 
Intervention 
Required 


Unexpected 
Drive Status 
(Initial Select) 


Device 
Equipment 
Checks 


Invalid 
Sequence 
(Not used 
Data Logged | Byte 1,Bit3=1) 


Storage Path | Transmit Tag 
Microcode- 
detected 
Error 


Message Codes (Bits 4 through 7 Hex) (Byte 1, Bit 3=0) 


| CCW Count 

- Less that 
Required 
(Device 
Fenced 

Byte1 ,Bit3=1) 


Data Value 
Not as 
Required 
(Not Used 


Diagnostic 
Command Not 
Permitted 
(Not Used 


Channel Retry 

Not Indicated CCW 
(Not Used (Not Used 

Byte 1,Bit 3=1) | Byte 1,Bit 3=1) 


Incorrect Retry 


Byte 1,Bit 3=1) | Byte 1,Bit 3=1) 


Transmit 
Target Error 


Transmit 
Offset Error 


Unexpected 

Drive Status 

(Retry/Read 
IPL) 


Sync-out 
Timing Error 


2 
Cluster 0 
Contro! (Not Usea) 
Equipment 
Checks 
3 
Storage Path —. 0 —_->--- 
Control (Not Used) 
Checks 


4 Data Check, | DataCheck, | DataCheck, | Data Check, Home Count Data Key Data Data Sync 

Data Checks |HomeAddress | CountField Key Field Data Field Address Sync | SyncFailure | Sync Failure Failure 

Field Failure (No Sync Byte) | (No Sync el (No Sync Byte) 
(No Sync Byte) 

5 0 0 Data Check, | Data Check, 

Data Check (Not Used) (Not Used) Key Field Data Field oe NOL eee 

with PCI Fetch (Correctable) | (Correctable) J 
Mode 

6 Channel A Channel! B Channel C Channel D 

Usage/Error Overrun Overrun Overrun Overrun ~~ (Not Use) —————— 

Statistics Counter Counter Counter Counter 


6-6 
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7 No Message Micro- 0 Channel Read/Write SPUD Firmware- 
Storage Path processor (Not Used) Interface (Not G28 Check-1 Check-1 detected 
Check 1 Check-1 Check-1 Check-1 
8 No Message Read/Write Read/Write Read/Write Channel 
Storage Path Check-2 Check-2 Check-2 Interface ; 0 . 
Check 2 Data Transfer (Not Used) 
Check-2 
9 No Message Device Head Address 
Device Read, a 0 ee ee ee are Check-2 Miscompare 
Write, and (Not Used) 
Seek Check 


continued 
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Sense Byte 7 Formats and Message Codes 


Table 6-3. Formats and Message Codes in Sense Byte 7 (continued) 


Format Message Codes (Bits 4 Through 7 Hex) (Byte 1, Bit 3=0) 


(Bits 0-3 
Hon LACSEA AEA ee 


Reset Storage Path improper Status Not As 
Notification Restart (Not eee Alternate Track Required 
(Not Used (Not Used Pointer (Not sae (Reason Code 
Byte 1,Bit3=1) | Byte 1,Bit 3=1) (Not Used in Byte 8 - see 
Byte 1,Bit 3=1) note) 


Sector 
Noncompare 
Check 


Device 
Equipment 
Checks 


Drive Not Seek Error Seek No Interrupt 0 Drive Check-2 0 
Ready for (Physical Incomplete from Drive (Not Used) Condition (Not Used) 
Command Address on Retry 

Miscompare) 


2 Cluster Control Microcode- 
Cluster Check-2 0 detected 
Control (Not Used) Errors 

Equipment (Reason Code 
Checks in Byte 8) 


3 Allegiance 
Storage Path Terminated 
Control 


Trace Table | Power-up High Temp 0 
ase 0 : Saved Error on Fault of Power | “ (Not Used) —__” 
(Not Used) Another SP_ | Supply Failure 
Checks 
4 0 
Data Checks $$  — _—_—_—_ (Not Used) AA 


5 
Data Check (Not i 
with PCi Fetch 
Mode 


6 Channel A Channel B Channel C Channel D 
Usage/Error | Seeks/Bytes | Seeks/Bytes | Seeks/Bytes | Seeks/Byies | + (Nol seal —————— 
Statistics Read Counter | Read Counter | Read Counter | Read Counter 


7 
Storage Path 
Check 1 


Small Buffer 
Check-1 


Tall Buffer 
Check-1 


0 
= (Not Used) ———____________» 


8 Channel SP/Device SPUD Read Write 
Storage Path interlace Interface interface Microcode- Microcode- 0 
Check 2 Microcode- Microcode- Microcode- detected detected +———___ (Not Used) ——> 
detected detected detected Check-2 Check-2 
Check-2 Check-2 Check-2 


9 
Device Read, 
Write, and 
Seek Check 


Track Physical 
0 Address 0 | 
< a ee , eee LT 
(Not Used) Miscompare (Not Used) 
While Oriented 


Note: Reason Codes in Byte 8 
‘29’ = Perform Subsystem Function command was not ‘80’ = A specific command was issued to an interface 
issued with the Set Special Intercept Condition order that has been disabled for specific commands by a 


but no path group has been set. Perform Subsystem Function command with the Set 

Special Intercept Condition order. 

‘35’ = Diagnostic Control command with the Set 

Guaranteed Path subcommand was issued to a fenced ‘81’ = Attention was presented to an interface that 

path. has been disabled for specific commands by a Perform 
Subsystem Function command with the Set Special 


Intercept Condition order. 
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Sense Byte Definitions 


6.2 Sense Byte Definitions 


6.2.1 Sense Byte 0 


Bit 0 
Command 
Reject 


Bit 1 
intervention 
Required 


Bit 2 
Channel Bus 
Out Parity 


Bit 3 
Equipment 
Check 


6-8 


An invalid command has been issued. 
An invalid command sequence has been issued. 
An invalid or incomplete argument has been transferred by a control 
command. 
A command in the domain of a Locate Record does not conform with the 
operation parameter or the operation parameter of the Locate Record command 
specifies an operation the file mask inhibits. 
In the domain of a Locate Record command, a multitrack operation attempts to 
access a track that is outside the primary track group. 
The write portion of the file mask has been violated. 
A Format Write command was followed by a Space Count command (illegal 
sequence). Also, a Format Write command other than Write Home Address, 
Write Special Home Address, or Write Record 0 is to a track flagged as defective. 
A Record 0 Count field for a defective track pointed to itself or an alternate track 
replacing a defective track pointed to itself. 
. The unit has attempted to write an invalid Home Address. 
. Atrack has been formatted without a Home Address. 


The addressed device was not physically attached to the system or is disabled 
(the Device Enabled/Selected switch is set to the disabled (down) position). 
The addressed device was not available for use because the power is off. 

The addressed device is not ready or is in CE Mode (microcode). 


The SP has detected bad parity in data transferred from the channel. A parity error 
during command transfer does not cause a Command Reject. 


An unusual hardware condition has originated in the channel, SP, or drive. When 
this condition occurred, the SP instructed the operating system to store the first 
sense data and retry the failing operation up to nine times. Regardless of whether 
the retry cycle was successful, the system logged the error, indicating whether the 
condition was temporary (the retry succeeded) or permanent (the retry failed). 
Sense Bytes 7 through 23 contain additional information. The reader should note 
that Bit 3 can be set under any of the following circumstances. 


An active CCW chain was halted due to a hardware failure. 

The SP has executed a trace table save operation. In this case, Sense Byte 2, 
Bit 3 is also set. 

A Diagnostic Control command has inhibited execution of a Write command. In 
this case, Sense Byte 1, Bit 6 is also set. 


continued 
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Sense Byte Definitions 


Cc 6.2.1 Sense Byte 0 (Continued) 


Definition 


Bit 4 . Anuncorrectable Data Check has occurred. 
Data Check 2. AData Check has occurred but the error correction sequence was inhibited by the 
file mask setting. 
A Data Check occurred while PCi Fetch mode was set in the file mask. The error 
was corrected through a retry sequence and the valid data was forwarded to the 
channel. 


Bit 5 The SP did not receive a channel response to a data transfer request or an internal 
Overrun recovery reconnection request within the required time limit. The SP only sets Bit 5 if 
tfe retried condition occurs more than ten times in a single command chain or if the 
operation in question is not one that is normally retried. Command Overrun 
conditions are also retried by the SP; command overruns, however, do not set this 
bit. 


A Data Overrun terminates requests for data from the channel and, if writing a record 
at the time the overrun occurs, the remainder of the record is padded with zeros. If 
there is no response to an internal recovery reconnection request, the storage path 
is released and the overrun is reported to the next selection of the SP/device 
interface. 


ae Sy 


Not used (set to zero). 


3890-2.01-00 — 09/90 6-9 


Sense Byte Definitions 


6.2.2 Sense Byte 1 


Bit O 
Permanent 
Error 


Bit 1 
Invalid Track 
Format* 


Bit 2 
End of 


Cylinder 


Bit 3 
Message to 
Operator 


Bit 4 
No Record 
Found" 


6-10 


Definition 
This bit is set by the SP error recovery routines under a variety of conditions. The 
SP sets Bit O when a recovery attempt fails, when internal retries are not 
considered appropriate and the SP provides no other path, or when a retry is not 
desirable. 


An attempt has been made to write data that exceeds track capacity. This setting 
also occurs during a read, search, or write operation when Index is detected in the 
gap following a Count or Key field. Invalid Track Format is posted whenever a write 
operation has attempted to execute past the end of the track. In this case, part of 
the record is written into the Index; subsequent read and search commands 
(except Search !ID) executed against the partial track will show Bit 1 as set. A 
Search 1D command can find this partial record so that it can be erased. The 
command sequence is Search /D followed by Erase. Finally, Invalid Track Format 
is set whenever an Update Write operation is initiated against a field that has a 
different length (key length, data length) than specified by the record size 
parameter. 


Note: When this bit is set to 1, the residual CSW count in the interrupted CCW 
chain should not be used to determine track capacity because the residual count 
may not be accurate. 


A multitrack read or search cperation outside the domain of a Locate Record has 
attempted to continue beyond the addressable cylinder boundary. Additionally, 
End-of-Cylinder will be set if the subsystem encounters either a programming error 
or an expected End-of-Cylinder condition. 


1. When this bit and Byte 0, Bit 3 (Equipment Check) are both set, a trace table has 
been saved for the SP in question. 

2. When this bit and Byte 2, Bit 3 (Environmental Data Present) are both set, the 
SP has just completed sense data logging (auto-forced logging) for a particular 
error type. The auto-forced logging mode becomes inactive for the prescribed 
number of data or seek checks. A Format 0, message 1 is indicated in Byte 7, and 
a message is sent to the operator console. 


1. Two Indexes have been sensed in the same command chain without an 
intervening read in the Home Address field or a Data field. 

2. Two Indexes have been sensed in the same command chain without an 
intervening Write, Sense, or Contro/command. 


Note: The 3890 verifies correct actuator positioning before setting this bit. 
3. Inthe domain of a Locate Record command, the search cannot find either 
Record 0 or a user record after a cylinder or head switch. imprecise Ending (Byte 


1, bit 7) is also set to 1. If the record search occurs after Device End for the 
Locate Record command, the error occurs in the following command. 


continued 
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Sense Byte Definitions 


6.2.2 Sense Byte 1 (continued) 


Bit 5 . The specified operation attempts to access a track outside the boundaries 
File established by a Define Extent command. 
Protected* . The seek controls of the file mask have been violated by a seek operation, a 

Recalibrate command, or a multitrack operation outside the domain of a Locate 
Record command. The Recalibrate command may have been received with 
diagnostic authorization specified. 
In the domain of a Locate Record command, a multitrack operation has attempted 
to access a track that is outside the primary track group. For this error, Command 
Reject (Byte 0, bit 0) is also set to 1. 
A CE cylinder seek has violated the file mask. 
A diagnostic command has violated the fie mask. The correct file mask for 
diagnostic operations on a CE cylinder is C4; for diagnostic operations on any track, 
the correct file mask is C6. 


Bit 6 This setting indicates that a Write command has been received on a channel which 
Write is governed by a write inhibit generated from a Diagnostic Controlcommand. Write 
Inhibited operations are inhibited to all devices on this storage path. The write inhibit condition 
occurs in conjunction with an Equipment Check (Byte 0, bit 3). Bit 6 is set on receipt 

of a Write or Locate Recordcommand. 


“oe. Bit 7 A CCW chain terminated abnormally within the domain of a Locate Record 
ae Imprecise command. The resulting status defines a previously executed CCW and indicates 


* —. 


Ending that the CCW address actually received does not agree with the CCW address 
expected by the SP. The condition occurs when an error is detected during the 
c search operation in the Locate Record command and the search is not completed 
until the SP receives the next command. 


* Caused by a CCW programming error or detection of an expected programming condition. 
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Bit O 
Request 
Write Inhibit 


Bit 1 
Correctable 


Bit 2 
First Logged 
Error 


Bit 3 
Environmental 
Data Present 


Bit 4 


Bit 5 
Imprecise 
Ending 


(Compatibility Bit) 


Bits 6 and 7 


Sense Byte Definitions 


6.2.3 Sense Byte 2 


Definition 


The SP has asked the host system to issue a Diagnostic Controi/command 
specifying the Inhibit Write subcommand (02). 


The SP encountered a Data Check (Byte 0, bit 4) or Data Overrun (Byte 0, bit 5) 
while PCI Fetch mode was set in the file mask. In this case, the incorrect data was 
initially forwarded to the channel. After this transaction, the SP transmitted the 
corrected data to the channel. 


The error threshold for temporary Data or Seek Checks has been exceeded. The 
auto-forced logging mode has just started for the device and will remain active for 16 
Data or Seek Checks. Byte 2, bit 3 (Environmental Data Present) is also set to 1. 


Sense Bytes 8 through 23 have usage counter statistics under Format 6. Usage 

Statistics contain the number of bytes read or searched, the number of overruns by 
the channel, and the number of Seek commands that have been processed by the 
subsystem. The format for Sense Bytes 8 through 23 is contained in Byte 7. Bit 3 is 
set with Format 6 to indicate a usage or error counter overflow, or a Head and Heset . 
Buffered Log command execution. Bit 3 indicates that the SP is in Logging Mode. 


Not used (set to Zero). 


This bit duplicates the setting of Byte 1, Bit 7 (Imprecise Ending) and is used for 
compatibility purposes only. 


Not used (set to zero). 


Caused by a CCW programming error or detection of an expected programming condition. 
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Sense Byte Definitions 


be 6.2.4 Sense Byte 3 


This byte contains the controller ID (storage path identifier), the residual record count, 
or the retry count depending on the format indicated in Sense Byte 7. Ee 


1. Controller ID — If Imprecise Ending (Byte 1, bit 7) is 0, Formats 1, 2, 6, 7, 8, and 9, 
indicate the controller ID as shown below. 


Note: The controller ID is in Byte 20 for Format 0 and in Byte 14 for Formats 4 
and 8. 


2. Residual Record Count — When either Imprecise Ending (Byte 1, bit 7) or File 
Protected (Byte 1, bit 5) is set to 1, Sense Byte 3 indicates the number of records 
that remain to be processed within the domain of a Locate Record command. 


3. Retry Count — When Imprecise Ending is set to 0 and Environmental Data 
Present (Byte 2, bit 3) is set to 1, Byte 3 for Formats 4 and 5 reports the number 
of retries used to recover the error. 


4. Sense Byte 3 is set to 00 for Formats 0 and 3, and for Formats 4 and 5 except 
when condition 3 above is encountered. 


a 
Bits 0-7 For sense byte Formats 1, 2, 6, 7, 8, and 9, these bits contain the controller [ID when 
Cc Controller ID Imprecise Ending is set to zero. 
The CE sets the controller ID during the installation process by executing Routine 


48, Controller ID Selection. 
Controller IDs must be in the range of 02 through FD, and all four storage paths 
should have the same controller ID. 
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Sense Byte Definitions 


6.2.5 Sense Byte 4 


pe Detniton | 


Bits O, 1 These bits indicate the SP that was in use when the sense data was gathered. The 
Path In Use bit setting is as follows: 


Bits 
0-1 Significance 


00 SP 0 was in use. 
01 SP 1 was in use. 
10 SP 2 was in use. 
11 SP 3 was in use. 


Bits 2-7 These bits contain the logical device address (00 through 3F). 
Logical Device 
Address 


6.2.6 Sense Byte 5 


a 


Bits 0-7 This byte contains the low-order cylinder address for all formats except for 
Low-Order Formats 3 and 6. 
Cylinder 


Address Bit 0 =128 Bt3= 16 Bit6 = 2 
Bitl = 64 Bit4= 8 Bit7 = 1 


Bit2= 32 BitS= 4 


Under Format 6, Byte 5 is set to 01 if the Command Overrun counter has 
overflowed. 


If the storage path is not reporting device status, this byte contains zeros. 
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Sense Byte Definitions 


ve 
Cc 6.2.7. Sense Byte 6 
a 
Bits 0-7 1. This byte contains the high-order cylinder and head address of the most recent 
High-Order access position for all formats except for Format 6. 
Cylinder and 
Head Address Cylinder Address Head Address 
BitO = 2048 Bit 4 = 8 
Bitl = 1024 BitS =4 
Bit2= 512 Bit 6 =2 
Bt3= 256 Bit 7 = 1 
Under Format 6, this byte is set to 01 if the Sata Overrun counter has overflowed. 
lf the storage path is not reporting device status, this byte contains zeros. 
6.2.8 Sense Byte 7 
a 
( = Bits 0-3 These bits indicate the format of Sense Bytes 8 - 23 (Table 6-2). 
a Format 


0000 = Format 0 — Program or System Checks 
0001 = Format 1 — Device Equipment Checks 
SS 0010 = Format 2 — Cluster Control Equipment Checks 
0011 = Format 3 — Storage Path Control Checks 
0100 = Format 4 — Data Checks 
0101 = Format 5 — Data Checks with PCl Fetch Mode 
0110 = Format 6 — Usage/Error Statistics 
0111 = Format 7 — Storage Path Check-1 Errors 
1000 = Format 8 — Storage Path Check-2 Errors 
1001 = Format 9 — Device Read, Write, or Seek Checks 


Bits 4-7 These bits describe the error conditions for the above formats. Messages for Formats 0-9 are 
Message Codes defined in Table 6-3. 
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© Appendix A 
List of Abbreviations 


AF — Advanced Function 

BDAM — Basic Direct Access Method 

BISAM — Basic Indexed Sequential Access 
Method 

BPAM — Basic Partitioned Access Method 

BSAM — Basic Sequential Access Method 

Cc — Cylinder 

CCU — Cluster Control Unit 

CCW — Channel Command Word 

CE — Customer Engineer — 

CMS — Conversational Monitor System 

CPU — Central Processing Unit 

CSW — Channel Status Word 

CTL — Control 

DASD — Direct Access Storage Device 

DOR — Dynamic Device Reconnect 

dec — Decimal 


Device Support Facilities 


© 
¢) 
nN 
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ECC — Error Correction Code 
EOC — Endof Cylinder 
| EPO — Emergency Power Off 
EREP — Environmental, Recording, Editing 
and Printing Program 
ESA — Enhanced System Architecture 
F — Flag 
H — Head 
HA — Home Address 
HAR — Head Address Register 
hex — Hexadecimal 
HPO — High Performance Option 
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Initial Microprogram Load 
Input/Output 

Device Support Facilities 

indexed Sequential Access Method 


Job Control Language 
Multiple Virtual Storage 
Operating System 


Printed Circuit Board 
Power Sequencing Unit 


Queued Indexed Sequential Access 
Method 
Queued Sequential Access Method 


Record 

Standalone 

Sequential Access Method 

Start |/O 

Storage Path 

Transfer In Channel 

Unit Control Word 

Volume Level Selection Enhanced 
Virtual Machine 

Virtual Storage Access Method 


Volume Table of Contents 


Extended Architecture 
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© Appendix B 
Data Conversion and Media 
Considerations 


B.1 Introduction 


This section discusses some of the issues that the customer should consider when 
migrating data sets from previous drive generations (3650, etc.) to the 3890. Among the 
subjects that will be covered are data management philosophy, volume initialization, 
blocking, space calculation, and data set conversion. This section assumes a basic 
knowledge of access methods and the operating systems compatible with the 3890. As a 
point of reference, some of the terms used in the course of this discussion are defined as 
follows. 


¢ Physical Record — A physical record is the increment used to organize data on 
a track. Minimally, a physical record is composed of a Count field and Data field. The 
Count field contains the location of the record and a description of its attributes. The 
(: Data field stores data; the length of the Data field is determined by the Count field 
= and is controllable by the customer. Accounting for track overhead (i.e., Home 
Address, etc.), the Data field may not exceed the usable area of one track. A physical 
& record may also include a Key field which provides indexing information for the Data 
field. Physical records contain one or more logical records. 


oe 


rd + 


¢ Logical Record — A logical record is the increment that the CPU uses when 
processing data; the value of this increment is customer-assigned. The length of a 
logical record does not necessarily correspond to the length of the physical record in 
which it is located. For instance, to meet the line length requirements for a particular 
terminal, the customer may assign a logical record:length of 80 bytes to a set of data. 
At the same time, the customer may assign a length of 3200 bytes to the Data field 
that contains the logical record group. Thus, the physical record would include 40 
logical records. 


¢ Block —A block is the increment of data transmitted to the system. The size of a 
given block is in a one-to-one ratio with the Data field length. In other words, if a 
physical record has a data length of 3200 bytes, the block size is also 3200 bytes. 
When determining block size, the length of the Key field, when present, must be 
considered. Block size is always a multiple of logical record length. Block size and 
logical record length are assigned via Job Control Language (JCL) statements or 
macros in any operating system environment. 
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Data Management Philosophy 


B.2 Data Management Philosophy J 


Before planning the specifics of data migration and layout, the customer should 
determine which of the drive performance criteria is central to the installation and 
application. For instance, customers wishing to reap the benefits of the drive’s 
comparative processing speed should structure data set layout for fast access and 
turnaround. 


Customers who wish to utilize the increased storage capacity of the unit may plan data 
blocking so that a high percentage of track space will be devoted to data storage. The 
customer may find it necessary to make certain performance compensations. As an 
example, the use of full track blocks maximizes the amount of space dedicated to data 
storage. 


However, the length of time required to perform a data transfer for a block this size may 
result in a channel bottleneck. Thus, the customer should decide which of these two 
factors is crucial to the application and should find an appropriate balance. As a rule, the 
customer should consider the priorities of the installation, the expected traffic, and the 
types of data to be stored when planning the conversion and layout. The following 
paragraphs furnish some pointers on how to ensure that the various performance 
characteristics are taken into account. 


To minimize CPU interference on I/O accesses, the customer may use three techniques. 
First, the customer should optimize the number of accesses for a given level of system 
activity. To accomplish access reduction, the customer may use larger block sizes to 
ensure the maximum data transfer per access, may place frequently accessed | 
information in main storage at the start of a job or at system initialization, and may JZ 
employ chained scheduling to access multiple blocks of sequential data. Chained 

scheduling allocates a group of chained buffers for a rapid series of read or write 

operations and ensures that the read or write operations are synchronized with buffer 

allocations. Second, the customer should employ large block sizes to ensure against an 

increase in Start I/O (SIO) operations. Third, the customer should take care in specifying 

the space allocation. For example, if a data set is large enough to merit a cylinder 

allocation instead of a track allocation, the space should be assigned in cylinder units 

instead of track units. This approach eliminates the time required for the control 

program to review the record extent each time it finishes a track. 


Note: If chained scheduling is active, the customer should verify that main storage 
has enough space to accept the data blocks. 


To minimize the time that a channel is busy, the customer may employ four techniques. 
First, the customer should reduce block size on direct access data sets. Second, if the 
customer stores a high number of data sets, an indexed VTOC will minimize search time. 
Third, the customer may reduce search time by creating small directories for partitioned 
data sets. Fourth, the customer may utilize either a fixed record length with standard 
record format or the search direct option when handling sequential data sets. 


Note: If search direct is specified in conjunction with chained scheduling, chained 
scheduling will supersede the search direct option. ce 
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Volume Initialization and VTOC 


c To reduce the amount of arm movement entailed in accessing data, the customer may 
utilize seven techniques. First, arm motion will be minimized if the customer groups 
small, frequently used data sets on one cylinder instead of on separate cylinders. Second, 
the customer should ensure that frequently accessed sections of partitioned data sets are 
located near the data set directory. Third, the customer should make sure that all defect 
skips are assigned prior to linking an alternate track (see Section 4). This measure 
reduces the number of alternate track accesses performed; the customer may also 
consider placing rarely used data sets on tracks that have assigned alternates. Fourth, if 
the customer is storing relatively small data sets that are frequently accessed, these data 
sets should be grouped near the center of the cylinder range. Fifth, the customer should 
make sure that data sets receive an accurate space allocation to avoid large groups of 
unused cylinders. Sixth, the customer should generally locate the most frequently 
accessed permanent data sets at the center of the cylinder range. Seventh, if 
concurrently active data sets use the same actuator, these data sets should be clustered 
over adjacent cylinder groups. 


To increase the data transfer speed and decrease the time necessary for an access 
operation, the customer may employ seven techniques. First, the customer may use a 
fixed record length with standard record format or the direct search option. Second, the 
customer should ensure that data sets are arranged so that the data sets that are highly 
active are evenly mixed with less active data sets. Third, the customer should take 
advantage of any high-speed channel features whenever possible. Fourth, the customer 
7 should minimize the number of data sets that are concurrently active on the same 
( actuator. Such data sets should be distributed over several different actuators. Fifth, the 
Se customer should ensure reduced arm motion as described in the previous paragraph. 
Sixth, taking advantage of the four clustered storage paths, the customer should use 
Se different paths to access simultaneously active data sets. Seventh, for direct access data 
sets, the customer should block data in smaller segments. 


B.3 Volume Initialization and VTOC 


One of the tasks that must be performed before storing data in the drive is volume 
initialization. A portion of volume initialization is completed prior to drive shipment; this 
portion consists of writing a Home Address, standard Record 0, and any necessary defect 
skips on each track. After installation, volume initialization must be completed to 
prepare the drive for use by the operating system. The customer generally executes the 
IBM Device Support Facilities (DSF) program to accomplish this task. Using the DSF 
INIT command, any of three initialization levels may be achieved. 


The first of these performs two tasks. Level 1 initialization writes Initial Program Load 
(IPL) bootstrap records and a volume label. The bootstrap records are defined on cylinder 
0, head 0 — records 1 and 2; the volume label is located on cylinder 0, head 0 as record 3. 
Level 1 initialization also defines the size and starting point of the Volume Table of 
Contents (VTOC). If the customer is executing under an OS/VS system, the VTOC 
location default of cylinder 0, head 1 and the VTOC size default of one track will be 
employed unless otherwise specified. The second volume initialization level includes 
three tasks — the two tasks performed at Level 1 and an additional track reformat 

2 function that guarantees correct addressing. The track reformat function consists of a 

SEs Home Address/Record 0 write for all tracks and thus erases any previous track contents. 
: Level 2 volume initialization is required for all replacement drives. The third volume 
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Blocking 


B.4 


B-4 


ah ot. a et 
. oa 


initialization level executes the three tasks performed at Level 2 as well as a surface 
analysis which ensures the assignment of all necessary defect skips. Surface analysis 
consists of extensive track testing using worst case data patterns; the purpose of the test 
is to find data check errors and assign defect skips or alternate tracks as apprgpriate. 
Surface analysis does not eliminate defect skips written prior to shipment. If a defective 
track proves usable during testing, surface analysis will reclaim that track for normal 
operating functions. 


Among the items crucial to drive performance is the VTOC. The VTOC is a sequential 
data set required for each cylinder group or volume. If the customer is operating the 3890 
in an OS/VS environment, a VTOC index option is available. The VI'OC index can 
minimize the search time required for VTOC review by providing the data set name and 
its VTOC location; the VTOC may then be accessed directly rather than in a sequential 
read. Customers who store large numbers of data sets per volume may find an indexed 
VTOC helpful. The VTOC index is created during volume initialization via the DSF INIT 
command or at a later time via the BUILDIX command. The customer should consider 
locating the VTOC index near the VTOC to minimize arm motion. 


Blocking 


One of the areas that the customer must examine is blocking. As previously mentioned, a 
block is the increment used to transmit data; block size corresponds to the data length of 
a physical record and must be a multiple of the fixed-length logical record size. Choosing 
the most effective block size for a given application depends on several factors. For 
instance, if the customer has an application that requires data set transfers between 
different drive types on a regular basis, a block size close to 6,233 bytes provides 90% 
space utilization for the 367x, 365x, 368x, and 3890 drive classifications. Thus, 
transferability with high space utilization is achieved. On the other hand, if the customer 
is working with system data sets which require larger blocks for peak performance, a 
block size of 15,476 will maximize space utilization for the track and transmit the system 
data in appropriately large units. As a general guideline, the customer should be aware 
of the following blocking characteristics. 


¢ Very large block sizes (i.e., full track length) achieve high space utilization, but 
may monopolize a channel during data transfer and impact real time users. 


¢ The smaller the block size, the greater the percentage of track overhead and the 
smaller the percentage of track used for data storage. 


¢ Block sizes in the range of 3,000 to 8,000 bytes provide a better space utiliza- 
tion/performance balance than block sizes at either the upper or lower extreme. 


¢ Block sizes must be adjusted for the amount of main storage devoted to I/O buffers. 


e Large block sizes are appropriate for sequential physical records as long as they do 
not adversely affect response turnaround for real time users. 


¢ Large block sizes can result in data transfer delays for random data set processing 
by key. 


e Virtual Storage Access Method (VSAM) data sets use a control interval as the unit 
of data. Control interval block sizes are multiples of 512 bytes up to 8 kilobytes 
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space Calculation 


ave 
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Ss and are then increased by increments of 2 kilobytes. For VSAM, 85% space utiliza- 
| tion may be achieved on the 3890 by a block size of 4,096 bytes. | 


B.5 Space Calculation ° 


To ensure correct data layout, the customer must accurately calculate the number of 
records that will fit on a track. The customer may use one of two algorithms to perform 
this calculation. The first of these algorithms applies in situations where all records on 
the track are assigned the same length. The second algorithm is appropriate when 
dealing with unequal record lengths on the same track. The following text presents both 
algorithms. Additionally, Tables B-1 through B-3 calculate the allowable number of 
records for given record lengths. 


Note: All 3890 data is organized in 32-byte increments. Because this approach 


affects portions of the calculation, areas where the 32-byte increment must be 
observed are so noted. 


Algorithm 1 — Physical Records of Equal Length 


For equal length records with a standard Record 0, the customer should calculate as 
follows: 


( ED = Number of records per track 

where 1499 = The number of 32-byte increments available for customer data. 
C =The number of 32-byte increments used by the Count field and all record gaps. 
K = Key length to the nearest 32-byte increment, rounded upward. 
D = Data length to the nearest 32-byte increment, rounded upward. 


Key length and data length are further calculated as follows: 


K — Length of the Key Field + 12 bytes error correction 
- 32 


D = Length of the Key Field + 12 bytes error correction 
7 32 


Note: The value of C is 15 if no Key field is present or 22 if a Key field is used. If 
records are not keyed, K is 0. 


Example: 


Key length = 12 Data length = 370 


ce thus: 
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Data Conversion 


C = 22 because the Key field is present 


(12+ 12 | 24 <i 


kL. = 30 I 39 OF 1, rounded upward : 
370+12 382 
D = 32% go 8 12, rounded upward 


1499-1499 
924+1+12°" 35 


Records pertrack = or 32 records 


Algorithm 2 — Physical Records of Unequal Length 


- 


For unequal length records with a standard Record 0, the customer should calculate as 


follows: 
n 
>> (Cx + Kx + Dx) ¢ 1499 } = number of records per track 
x= 1 
For equal length records with a nonstandard Record 0, the customer should calculate as 
follows: 
C 
> (Cy + Kx + Dx) < 1515 >} = number of records per track 
x=0 


Note: See Algorithm 1 for definitions of C, K, and D. The customer may find the 
MVS TRKCALC macro useful in performing these calculations. 


B.6 Data Conversion 


The method by which data is converted from an older device to the 3890 depends on the 
operating system, the drive, and the access method used to perform the I/O operations. 
For MVS environments, the most convenient approach to data conversion is to use an 
IBM utility program. The IBM utilities provide copy operations, and in some cases, move 
operations. The choice of a particular utility program or command is an outcome of the 
access method employed. Utility choices are as follows: differences in conversion results 


are noted. 
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Compatible Operating Environments 


Cc Access Method/Data Set Type: Utility: 

SAM,BSAM,QSAM IEGENER 
IEHMOVE - 

VSAM Access Methods Services 
REPRO Command 

BDAM IEHMOVE* 

BPAM IEBCOPY (does not rearrange members) 
IEHMOVE (rearranges members alphabetically) 

ISAM,BISAM,QISAM IEBISAM** 

* 


Normal reorganization programs will aid data transfer in cases where the number 
of records per track for the 3890 is greater than the number of records per track 
for the older device. 


** The customer should alter load programs to reflect 3890 device characteristics, as 
appropriate. 


Note: If converting cataloged data sets, the catalog must be revised. 


For VM environments, the customer may issue CMS commands to migrate data to the 
3890. Commands that may prove useful are COPYFILE, MOVEFILE, TAPE, and 
- TAPPDS. If the customer converts system data sets on CP-OWNED cylinders, those data 
(: sets require reconstruction. 


© B.7 Compatible Operating Environments 


The 3890-2 subsystem is designed to function in a number of operating environments. 
Among these environments are MVS/370, MVS/XA, MVS/ESA, VM/SP, VM/SP HPO, 
VM/XA, and VSE/SP. Over time, these control programs have undergone various 
revisions — some minor and some more dramatic. This subsystem is compatible with the 
control program revisions that support IBM 3380 J-type and K-type devices; all 
minimum contro] program revision levels required by these IBM devices are also 
required by the 3890-2 subsystem. Thus, the system programmer must determine 
whether the control program release and version currently installed at the site are 
compatible with the 3890 subsystem. This task should be completed during the 
installation planning phase. For the programmer’s convenience, Table B-4 provides the 
minimum required release or version number for the listed operating environments. 
Additionally, this table furnishes information on the minimum release/version of the 
EREP and ICKDSF support programs required by the 3890. If, on reviewing this table, 
the programmer finds that a control or support program is not compatible with the 3890, 
appropriate action should be scheduled prior to subsystem installation. 
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Equal Length Physical Records With Keys 


Table B-1. Equal Length Physical Records With Keys J 


Key Length + 
Data Length Track Capacity Cylinder Capacity 
Bytes 
(maximum) Records Bytes Records Bytes 


708,600 
697,200 
685,800 
674,400 
663,000 
651,600 
642,600 
630,720 
618,840 
606,000 
997,960 
583,200 
9/5,640 
566,160 
549,000 
539,520 
532,440 
520,560 
903,880 
492,000 

486,360 J 
477,840 

466,440 

452,160 

435,000 

427,440 

417,960 


continued 
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Equal Length Physical Records With Keys (continued) 


Se Table B-1. Equal Length Physical Records With Keys (continued) 


Key Length + 
Data Length Track Capacity Cylinder Capacity 
Bytes 
(maximum) Records Bytes Records Bytes 


406,560 
393,240 

378,000 

375,720 

357,120 

352,440 

346,800 

323,400 

315,360 

306,360 

296,400 

285,480 

273,600 

260,760 

246,960 

. 237,600 
( 221,400 
204,240 

C 190,080 
170,520 

153,000 

133,560 

112,200 

88,920 

63,720 

37,200 


Note: Key length and Data length are rounded to multiples of 32, minus 12. 
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Equal Length Physical Records Without Keys 


Table B-2. Equal Length Physical Records Without Keys J 


Key Length + | 
Data Length Track Capacity Cylinder Capacity 
Bytes | 
(maximum) Records Bytes | Records Bytes 


1 
2 
3 
4 
5 
6 
7 
8 
9 


continued 
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Equal Length Physical Records Without Keys (continued) 


Cc Table B-2. Equal Length Physical Records Without Keys (continued) 


Key Length + 
Data Length Track Capacity Cylinder Capacity 
Bytes 
(maximum) Records Bytes Records Bytes 


437,340 
430,920 
423,540 
415,200 
405,900 
395,640 
393,360 
380,700 
367,080 
360,000 
343,980 
333,540 
321,180 
306,900 
290,700 
272,580 
256,680 
237,900 
= 216,240 
191,700 
164,280 
135,720 
104,580 
68,640 
27,900 


as 
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Ranges of Key Lengths 


Table B-3. Ranges of Key Lengths 


Key Length = 1 to 20 Records 
Data Length Bytes Per 
Maximum Track 
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continued 
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Ranges of Key Lengths (continued) 


Cc Table B-3. Ranges of Key Lengths (continued) 


Key Length = 1 to 20 Records é 
Data Length Bytes Per 
Maximum Track 


Key Length = 21 to 52 Records 
Data Length Bytes - Per 
Maximum Track 


. C continued 
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Ranges of Key Lengths (Contmued) ~ oe as 


Table B-3. Ranges of Key Lengths (continued) 


Key Length = 21 to 52 Records 
Data Length Bytes Per . 
Maximum Track 


ct 


continued 
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Ranges of Key Lengths (continued) 


Cc Table B-3. Ranges of Key Lengths (continued) 


Key Length = 53 to 84 Records . 
Data Length Bytes Per 
Maximum Track 


1 
2 
3 
4 
5 
6 
7 
8 
9 


continued 
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Ranges of Key Lengths (continued) #2 # er . 


Table B-3. Ranges of Key Lengths (continued) 


Key Length = 53 to 84 Records 
Data Length Bytes Per = 
Maximum 
continued 
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Ranges of Key Lengths (continued) 


Cc Table B-3. Ranges of Key Lengths (continued) 
Key Length = 85 to 116 Records . 
Data Length Bytes Per 
Maximum Track 
continued 
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Ranges of Key Lengths (continued) 


Table B-3. Ranges of Key Lengths (continued) 


Key Length = 85 to 116 Records 
Data Length Bytes Per 
Maximum Track 


continued 
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Ranges of Key Lengths (continued) 


Table B-3. Ranges of Key Lengths (continued) 


Key Length = 117 to 148 Records 
Data Length Bytes Per 
Maximum Track 


continued 
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Ranges of Key Lengths (continued) 


Table B-3. Ranges of Key Lengths (continued) 


Key Length = 117 to 148 Records 
Data Length Bytes Per 
Maximum 


Key Length = 149 to 180 Records 
Data Length Bytes Per 
Maximum Track 


continued 
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Ranges of Key Lengths (continued) 


a 
. * 


c Table B-3. Ranges of Key Lengths (continued) 


Key Length = 149 to 180 Records 
Data Length Bytes Per 
Maximum Track 


continued 
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Ranges of Key Lengths (continued) 


‘ Table B-3. Ranges of Key Lengths (continued) 


Key Length = 181 to 212 Records 
Data Length Bytes Per ‘ 
Maximum Track 


continued 
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Ranges of Key Lengths (continued) 


'S Table B-3. Ranges of Key Lengths (continued) 


Key Length = 181 to 212 Records = 
Data Length Bytes Per 
Maximum Track 


. % 
oC 
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Ranges of Key Lengths (continued) 


Table B-3. Ranges of Key Lengths (continued) J 


Key Length = 213 to 244 Records - 
Data Length Bytes Per 
Maximum Track 


continued 
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Ranges of Key Lengths (continued) 


Table B-3. Ranges of Key Lengths (continued) 


Key Length = 213 to 244 Records - 
Data Length Bytes Per 
Maximum 


continued 
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Table B-3. Ranges of Key Lengths (continued) 


Key Length = 245 to 255 Records 
Data Length Bytes Per 
Maximum Track 


continued 
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Ranges of Key Lengths (continued) 


c Table B-3. Ranges of Key Lengths (continued) 


Key Length = 245 to 255 Records f 
Data Length Bytes Per 
Maximum 


3890-2.01-00 — 09/90 B-27 


Bact Ste bes XFTITEs er eyel ey ~! SIs: Me P Let bd POD LARC RE Be ter bt heh SR a habs Setups ta pL Prenat bd be te DL DC pT >CALa SEs PL PETe CODE PLOT RA Ri he BE he ot be SALES heh + eT TR Me eA eM Ta My PEE CUR EO TOC ele eee Mate tele Meer, Eee 
BASE DES br act bh So poh ED ENN EL beh ier beep aans Pag Momo 6 PRLS ER OS oS mSE BRED Wa Noth P ag EDOLSD PUREE AEM LN Lehr ober btn t Phos SRE EN EL SP aD CAR SLO S i SLAC PC Mae oe SES SMCRtED SS ROES EDS RBIS NGS bre EICe CAS Pe DE be bent SP RIATE SOR DEP EP CPLOSDON Be OEREBCOLS PTSER SPELT SPS PEPE DERE 


_t, ©. 8. *& 22 & ee? 


a OES 
why 


a ie Ie Oe eS ae 


Control and Support Program Requirements 


Table B-4. Control and Support Program Requirements 


Operating System 


VM/SP 
MVS/370 MVS/XA HPO 


4 
Release 1 : 
i i Release 2 ee wt. 
Control Version Version Version Version Version with 20 : 
Program 1.3.5 1.1.2 2.1.2 3.1 3.1 ae with PTEs 
Release 
: Version 
3.2.0" 


Version Version Version Version Version Version 
Version Version Version Version Version Version Version 
3.3.2 3.3.2 3.3.2 3.3.2 3.3.2 3.3.2 3.3.2 


= Version 3.1.2 also supports 3890-00K4/02K4 via SPE. 
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Index 


A 


Abbreviation A-1 

Access Authoriztion 3-6 
Access Method B-7 
Address byte 3-23 
Address range 2-5 
Addressable units 2-8 
Allegiance 3-45 
Alternate Track 4-2, B-3 
Alternate tracks 4-1, B-4 
Application Data 3-85 
Application Identifier 3-85 
Attention 3-4 


B 


BDAM B-7 

Beginning Extent 3-9 

Beginning of extent 3-5 

BISAM B-7 

Block B-1 

Block multiplexers 1-1 

Block size 3-5, 3-8, 3-16, B-1 - B-2, B-4 
BPAM B-7 

BSAM B-7 

Busy 3-4 


C 


Cautions 1-5 

CCW 3-5 

CCWs 3-1 

Chaining requirements 3-1 

Channel 2-6 

Channel Bus Out Parity 6-8 

Channel Command Words 3-1 

Channel enabled/selected indicators 2-6 

Channel enabled/selected switches 2-6, 2-10 - 
2-11 

Channel End 3-4 

Channel interface management 2-2 

Channel path identifier 2-6 

Channel Status Word 3-1 
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Channels 1-1 

Check 1 6-5 

Check 2 6-5 

Check-1 2-5 

CHPID 2-6 

Circuit breakers 2-4, 2-11 

Cluster Control Unit 1-1, 2-1 - 2-2, 5-1 

CMS B-7 

Command 
Command code 00 3-92 
Command code 02 3-58 
Command code 03 3-22 
Command code 04 3-34 
Command code 05 3-62 
Command code 06 3-47 
Command code 07 3-23 
Command code 09 3-76 
Command code 0A 3-79 
Command code 0B 3-23 
Command code 0D 3-63 
Command code OE 3-49 
Command code OF 3-25 
Command code 11 3-67 
Command code 12 3-55 
Command code 13 3-27 
Command code 14 3-41 
Command code 15 3-65 
Command code 16 3-54 
Command code 17 3-27 
Command code 19 3-66 
Command code 1A 3-57 
Command code 1B 3-23 
Command code 1D 3-64 
Command code 1E 3-51 
Command code 1F 3-28 
Command code 22 3-59 
Command code 23 3-30 
Command code 27 3-86 
Command code 29 3-74 
Command code 31 3-72 
Command code 34 3-36 
Command code 39 3-71 
Command code 3E 3-90 
Command code 44 3-45 
Command code 49 3-75 
Command code 51 3-73 
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index 


Command code 54 3-38 
Command code 5B 3-33 
Command code 5E 3-53 
Command code 63 3-5 
Command code 64 3-42 
Command code 69 3-75 
Command code 71 3-73 
Command code 73 3-85 
Command code 85 3-69 
Command code 86 3-47 
Command code 8D 3-70 
Command code 8E 3-49 
Command code 92 3-55 
Command code 94 3-40. 
Command code 96 3-54 
Command code 9A 3-57 
Command code 9D 3-68 
Command code 9E 3-51 
_ Command code A4 3-44 
Command code AQ 3-74 
Command code AF 3-31 
Command code B1 3-72 
Command code B4 3-39 
Command code B9 3-71 
Command code C4 3-78 
Command code C9 3-75 
Command code D1 3-73 
Command code DE 3-60 
Command code E4 3-35 
Command code E9 3-75 
Command code F1 3-73 
Command code F3 3-80 
Command code FA 3-89 
Command code x8 3-33 
Command code 3-1 - 3-3 
Command Overruns 6-1 
Command Reject 6-8 
Command retry 5-1 
Commands 3-1 - 3-3 
Command code 47 3-10 
Configuration Data 3-35 


Contingent Allegiance 3-41, 3-45 


Control commands 3-1 
Control program B-28 
Control Unit End 3-4 
Controller 3-35 
Controller ID 6-13 
Count Field 4-1 

CPU 2-10 

CPU ID 3-31 
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CSW 3-1, 3-4 
Cylinder 6-14 - 6-15 


D : 


Data Check 6-9 

Data conversion B-6 

Data Field 4-1 

Data length B-8 - B-27 

Data Overruns 6-1 

Defect Skip 3-76, 4-1 - 4-2 

Defect skips B-3 - B-4 

Define Extent 3-1, 3-5 
Parameters 3-5 

Define extent parameters 3-6 - 3-9 

Device 2-2, 2-10, 3-35 

Device address 2-5 

Device characteristics 3-43 

Device enabled/selected indicators 2-7 

Device enabled/selected switches 2-7, 2-10 - 
2-11 

Device End 3-4 

Device interface 2-7 - 2-8 

Device Release 3-2, 3-40 

Device Reserve 3-2, 3-39 

Device Support Authorization 3-6 - 3-7 

Device Support Facilities B-3 

Device type 3-85 

Diagnostic Authorization 3-7 

Diagnostic commands 3-3 

Diagnostic Control 3-3, 3-80 - 3-84 

Diagnostic Control parameters 3-80 

Diagnostic Read Home Address 3-3, 3-79 

Diagnostic routines 2-10 

Diagnostic Sense/Read 3-3, 3-78 

Diagnostic Write 3-3, 3-85 

Diagnostic Write Home Address 3-3, 
3-76 - 3-77 

Disable 2-6 

Disabled 2-7 

Disk Module 1-1 - 1-2 

Disk modules 2-2 

Drive drawers 1-2 

Drive Type 3-35 

Drives 2-2, 2-4, 2-11 

DSF B-3 - B-4, B-7 

Dual colored 2-7 


3890-2.01-00 — 09/90 


SO SR PEER SCRE DORE MEER RO RSLs sith itis SERoP BES 


index 


state 
eer 

ate 
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re et 
ete 
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ECC 5-1 

ECKD 3-5 

Emergency power 1-4, 2-1, 2-5 

Emergency power switch 2-4, 2-11 

Emergency power-down 2-10 - 2-11 

Enable 2-4 

Enable Write 3-80, 3-82, 3-84 

Enabled 2-6 - 2-7 

End of Cylinder 6-10 

End of extent 3-5 

Ending Extent 3-9 

Environmental Data Present 6-12 

Environmental Recording, Editing and 
Printing 6-1 

EPO 2-4 

Equipment Check 6-8 

Erase 3-2, 3-67 

EREP 6-1, B-7 

Error Correction Code 5-1 

Error Handling 5-1 

Extend Architechture 3-31 

Extended Count, Key, and Data 3-5 


F 


Fan 2-10 

Fans 2-11 

File Mask 3-29 

File Protected 6-11 
Fire protection 1-5 
First Logged Error 6-12 
Format 6-6 - 6-7, 6-15 
Format decode 6-4 - 6-5 
Format Write 3-15 
Format, sense byte 6-1 
Four-channel switch 1-1 
Function Order 3-86 


G 


Gaps 4-2 

Gigabytes 1-1, 1-3 
Global attributes 3-5, 3-8 
Grounding point 1-5 
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Head Address 6-15 - 
High temp LED 2-5 

High temp. indicator 2-5 

High temperature 2-5 

Home Address Field 4-1 


T/O operations 3-1 

Implicit Allegiance 3-45 
Imprecise Ending 6-11 - 6-13 
Indicators 2-2 

Inhibit Write 3-80 - 3-81, 3-84 
Initial Program Load B-3 
Interface management 2-2 
Intermixed 2-8 

Intermixed module 1-2 
Intervention Required 6-8 
Invalid Track Format 6-10 
ISAM B-7 


J 


Jd-type 3-35, B-7 

J-type module 1-2, 2-1, 2-8 
J-type volume 3-23 

JCL B-1 

Job Control Language B-1 


K 


K-type 3-35, B-7 

K-type module 1-2, 2-1, 2-8 - 2-9 
K-type volume 3-23 

Key Field 4-1 

Key length B-8 - B-27 

Key lengths B-12 - B-13 


L 


LED 2-5 - 2-7, 2-10 

LEDs 2-11 

Local mode 1-4, 2-1, 2-4, 2-10 - 2-11 
Locate Data Checks 3-78, 3-80, 3-84 
Locate Record 3-1, 3-10 
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index 


Command processing 3-13 
Operation Codes 3-14 
Search Operation 3-13 

Locate Record Command Parameters 3-11 - 
3-12, 3-15 

Locate Record operation codes 3-16 - 3-21 
Format Write 3-16 
Orient 3-14 
Read 3-20 
Read Data 3-17 
Read Track 3-19 
Write Data 3-14 
Write Track 3-18 

Locate Record parameters 3-10 
Auxiliary Byte 3-10 
Orientation and Operation Byte 3-10 
Search Argument 3-12 
Sector Number 3-12 

_ Seek Address 3-12 

Transfer Length Factor 3-12 

Logic gate fan 2-10 

Logic gate fans 2-11 

Logical Device 6-14 

Logical Record B-1, B-4 


M 


Maintenance panel 2-2 

Mask byte 3-5 - 3-7 

Megabytes 1-1 

Message codes 6-15 

Message to Operator 6-10 

Migration B-1 

Mulitrack 3-75 

Multitrack 3-47, 3-49, 3-51, 3-54, 3-73 - 3-74 
Multitrack Read Count 3-2 

Multitrack Read Count, Key, and Data 3-2 
Multitrack Read Data 3-2 

Multitrack Read Home Address 3-2 
Multitrack Read Key and Data 3-2 
Multitrack Read Record Zero (RO) 3-2 
Multitrack Search Home Address Equal 3-3 
Multitrack Search ID Equal 3-3 
Multitrack Search ID Equal or High 3-3 
Multitrack Search ID High 3-3 

Multitrack Search Key Equal 3-3 
Multitrack Search Key Equal or High 3-3 
Multitrack Search Key High 3-3 

MVS 3-31, B-6 

MVS/370 B-7, B-28 


vs 


Pie ee 


MVS/ESA B-7, B-28 
MVS/XA B-7, B-28 - | 


N ‘ 


No Record Found 6-10 
No-Op 3-22 

No-Operation 3-22 
Non-Operation (No-Op) 3-1 
Normal Authorization 3-6 


O 


Operating environments B-7 

Operating modes 2-1 

Operating system B-28 

Operator control 2-10 

Operator control panel 2-7 

Operator control panels 2-1, 2-3 

Operator panel 2-2 

Orient 3-15 

Overrun 6-9 : 
Overtemperature 2-4 ( 


) 


P.S. inop indicator 2-5 

Panel 2-10 

Parameters 3-1, 3-5 

for Partitioned data sets B-2 
Partitioned data sets B-3 

Path group ID 3-31, 3-36 

Path in Use 6-14 

PCI Fetch Mode 3-7, 3-29, 6-5 

Perform Subsystem Function 3-3, 3-86 - 3-88 
Permanent Error 6-10 

Physical drive 2-1 

Physical Record B-1, B-4 - B-5 
Physical records B-6, B-8 - B-11 

Power 2-4 - 2-5 

Power down 2-1 

Power sequence complete indicator 2-4 
Power sequence complete LED 2-10 - 2-11 
Power sequence switch 2-4, 2-11 
Power sequencing 2-10 

Power sequencing unit 2-4 

Power supplies 2-11 

Power supply 2-10 

Power up 2-1 
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Power-down 2-10 

Power-up 2-10 

Prepare for Read Subsystem Data 3-86 
Program Check 3-22 

Program Controlled Interrupt Fetch Mode 3-7 
PSU 2-4 - 2-5, 2-10 - 2-11 


Q 


QISAM B-7 
QSAM B-7 


R 


RO 3-54 

Read 3-15 

Read and Reset Buffered Log 3-2, 3-44 
Read Commands 3-2 

Read Configuration Data 3-3, 3-89 

Read Count 3-2, 3-55 - 3-56 

Read Count CCW suffix 3-10 

Read Count, Key, and Data 3-2, 3-51 - 3-52 
Read Data 3-2, 3-15, 3-47 - 3-48 

Read Device Characteristics 3-2, 3-42 - 3-43 
Read Home Address 3-2, 3-57 

Read IPL 3-2, 3-58 

Read Key and Data 3-2, 3-49 - 3-50 

Read Multiple Count, Key and Data 3-2 
Read Multiple Count, Key, and Data 3-53 
Read Record Zero 3-54 

Read Record Zero (RO) 3-2 

Read Sector 3-2, 3-59 

Read Special Home Address 3-79 

Read Subsystem Data 3-3, 3-90 - 3-91 
Read Track 3-2, 3-15, 3-60 - 3-61 

Ready 3-4 

Recalibrate 3-1, 3-27 

Record B-9 

Record format 4-1 

Records B-8, B-10 - B-27 

Remote mode 2-1, 2-4 - 2-5, 2-10 - 2-11 
Request Write Inhibit 6-12 

Reset Allegiance 3-2, 3-45 - 3-46 

Restore 3-1, 3-27 


S 
Safety precautions 1-4 


SAM B-7 
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SCP 3-31 . 
SCP ID 3-31 
Search argument 3-15 
Search Commands 3-3 
Search Home Address Equal 3-3, 371 
Search ID Equal 3-3, 3-72 - 3-73 
Search ID Equal or High 3-3 
Search ID High 3-3, 3-73 
Search Key Equal 3-3, 3-74 - 3-75 
Search Key Equal or High 3-3, 3-75 
Search Key High 3-3, 3-75 
Sector number 3-15, 3-30 
Seek 3-1, 3-23 
Seek Address 3-15, 3-23 - 3-24 
Seek Cylinder 3-1, 3-23 
Seek Head 3-1, 3-23 - 3-24 
Select Subsystem Data 3-78, 3-80, 3-82 
Select Trace 3-78, 3-80, 3-82 
Sense 3-2, 3-34 
Sense byte 6-4 - 6-5 
Format decode 6-6 
Message Code 6-6 - 6-7 
Sense byte 0 6-8 - 6-9 
Sense byte 1 6-10 - 6-11 
Sense byte 2 6-12 
Sense byte 3 6-13 
Sense byte 4 6-14 
Sense byte 6 6-15 
Sense byte 7 6-14 - 6-15 
Sense byte definitions 6-9 
Sense byte, definitions 6-8, 6-10 - 6-15 
Sense bytes 6-1 - 6-3 
Sense commands 3-2 
Sense data 6-1 
Sense /O 3-34 
Sense ID 3-2, 3-35 
Sense Path Group ID 3-2, 3-36 - 3-37 
Sense Subsystem Status 3-2, 3-38 
Sequential data sets B-2 
Set File Mask 3-1, 3-28 
Set Guaranteed Path 3-80 - 3-81, 3-84 
Set Path Group ID 3-1, 3-31 - 3-32 
Set Sector 3-1, 3-30 
Set Special Intercept Condition 3-86 - 3-87 
SP 2-5 
SP check indicators 2-5 
SP check LED 2-10 
SP management 2-2 
SP pending indicators 2-5 
SP power indicators 2-5 
SP power LEDs 2-10 - 2-11 


SP power switches 2-5, 2-11 
Space calculation B-1, B-5 
Space count 3-1, 3-25 - 3-26 
SPs 2-4 

Start Application 3-78, 3-80, 3-83 - 3-84 
Statistical/error recording 6-1 
Status byte 3-38 

Status modifier 3-4 

Storage capacities 1-3 

Storage clusters 1-1 

Storage paths 2-2, 2-4, 2-7, 2-10 
Subsystem 1-1, 2-10 
Subsystem ID 2-5 

Subsystem identifier 2-5, 3-38 
Subsystem management 2-2 
Support program B-28 

Surface analysis B-4 

Suspend Multipath Reconnection 3-1, 3-33 
Switches 2-2 

SYS1.LOGREC 6-1 

System Control Program 3-31 


+ 


Test VO 3-3, 3-92 

TIC 3-33 

Track format 4-1 

Transfer length factor 3-15 - 3-16 
Transfer-in-Channel 3-1, 3-33 
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Unconditional Reserve 3-2, 3-41 
Unfence 3-80, 3-82, 3-84 
Uninsulated voltages 1-5 

Unit Check 3-4 

Unit Exception 3-4 

Unit status 3-1, 3-4 
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Virtual Storage Access Method B-4 
VM/SP B-7, B-28 

VM/SP HPO B-7, B-28 

VM/XA B-7, B-28 

Volume 2-5, 2-7, 2-10 

Volume initialization B-1, B-3 
Volume Table of Contents B-3 
Volumes 1-1, 2-2 
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VSAM B.-4, B-7 
VSE/SP B-7, B-28 . 
VTOC B-2-B-4 S| 
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Warnings 1-5 

Write Commands 3-2 

Write Count, Key and Data 3-2 

Write Count, Key and Data Next Track 3-2 
Write Count, Key, and Data 3-64 

Write Count, Key, and Data Next Track 3-68 
Write Data 3-2, 3-15, 3-62 

Write Home Address 3-2, 3-66 

Write Inhibited 6-11 

Write Key and Data 3-2, 3-63 

Write Record Zero (RO) 3-2, 3-65 

Write Special Home Address 3-76 

Write Track 3-15 

Write Updata Key and Data 3-70 

Write Update Data 3-2, 3-69 

Write Update Key and Data 3-2 
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XA 3-31, 3-36 
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